原文 : tomczhen的博客

在Jenkins平台上使用Ant脚本构建iOS项目, 可以做到自动构建打包, 上传蒲公英, 构建完成发送微信通知 等功能. 发布开发者进行测试分发,只需要点一下即可完成一系列操作.

Jenkins构建面板


安装CocoaPods

  1. 更新Ruby

     gem update --system
    
  2. 修改Ruby安装源

     gem sources --remove https://rubygems.org/
     gem sources -a https://ruby.taobao.org/
    

    注:使用gem sources -l命令查看源列表

  3. 安装cocoapods

     sudo gem install cocoapods
    

xctool安装

  1. 安装brew

     ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    
  2. 安装Xcode’s Command Line Tools

     xcode-select install
    
  3. 使用brew安装xctool

     brew install xctool
    

安装Apache Ant

  • brew install ant
    

配置运行环境

在Jenkins的系统设置页面设置ANT_HOME路径,并在全局属性中添加以下键值。

  • LANGzh_CN.UTF-8
  • PATH系统PATH输出值

编写Ant脚本

  • 官方手册,可以查看可用的任务或命令以及具体的参数,实例。

添加Jenkins任务

  • 新建任务类型”构建一个自由风格的软件项目”,选择源代码管理的方式。在”增加构建步骤”中选择Invoke Ant,打开高级选项,配置好Targets,在Build File中输入配置好的build.xml文件路径。

  • 注意:可以在任务中只配置源代码管理,执行任务测试获取代码是否正常,然后在服务器上的命令行界面中使用ant命令调用项目中的build.xml文件进行编译测试。


脚本实例

脚本说明:

  • ant脚本本质上还是通过调用xctool或xcodebuild命令进行iOS打包
<?xml version="1.0" encoding="UTF-8"?>
<project name="antProjectName" default="config.dev, modify, pack, pgy">
    <property name="project.name" value="projectName" />
    <property name="project.workspace.name" value="workspaceName" />
    <property name="project.scheme.name" value="schemeName" />
    
    <exec executable="date" outputproperty="build.time" failifexecutionfails="false" errorproperty="DateError">
        <arg value="+%Y%m%d%H%M" />
    </exec>
    
    <!-- 获取当前 Git 版本控制信息 -->
    <exec executable="git" outputproperty="git.tag" failifexecutionfails="false" errorproperty="GitTagError">
        <arg value="describe" />
        <arg value="--tags" />
    </exec>
    <exec executable="git" outputproperty="git.commit" failifexecutionfails="false" errorproperty="GitCommitError">
        <arg value="log" />
        <arg value="--pretty=format:%h" />
        <arg value="-n1" />
    </exec>
    <exec executable="git" outputproperty="git.log" failifexecutionfails="false" errorproperty="GitLogError">
        <arg value="log" />
        <arg value="--pretty=format:%B" />
        <arg value="-n1" />
    </exec>
    <target name="config.dev">
        <property name="project.profile.name" value="adhoc" />
        <!-- 构建开发环境配置信息 -->
        <property name="build.type" value="Dev" />
        <property name="build.config.name" value="开发环境" />
        <property name="build.file.path" value="dev" />
        <property name="build.file.name" value="${project.name}_${git.tag}_beta${build.time}" />
        <property name="pgy.description" value="LAN-Beta${line.separator}Tag:${git.tag} Commit:${git.commit}${line.separator}${git.log}" />
        <!-- 接口服务器地址 -->
        <property name="api.url" value="http://api.dev.server.com" />
        <!-- 第三方 Key -->
            <!-- 融云 -->
            <property name="key.rongcloud" value="rongcloud" />
            <property name="key.rongcloud_scid" value="rongcloud_scid" />
        
        <property name="build.file.url" value="http://www.pgyer.com/pgy" />
        <property name="build.file.qrcode" value="http://www.pgyer.com/app/qrcode/pgy" />
    </target>
    
    <target name="config.beta">
        <property name="project.profile.name" value="adhoc" />
        <!-- 构建测试环境配置信息 -->
        <property name="build.type" value="Beta" />
        <property name="build.config.name" value="测试环境" />
        <property name="build.file.path" value="beta" />
        <property name="build.file.name" value="${project.name}_${git.tag}_beta${build.time}" />
        <property name="pgy.description" value="Beta${line.separator}Tag:${git.tag} Commit:${git.commit}${line.separator}${git.log}" />
        <!-- 接口服务器地址 -->
        <property name="api.url" value="http://api.beta.server.com" />
        <!-- 第三方 Key -->
            <!-- 融云 -->
            <property name="key.rongcloud" value="rongcloud" />
            <property name="key.rongcloud_scid" value="rongcloud_scid" />
        
        <property name="build.file.url" value="http://www.pgyer.com/pgy" />
        <property name="build.file.qrcode" value="http://www.pgyer.com/app/qrcode/pgy" />
    </target>
    
    <target name="config.release">
        <property name="project.profile.name" value="adhoc" />
        <!-- 构建生产环境配置信息 -->
        <property name="build.type" value="Release" />
        <property name="build.config.name" value="生产环境-蒲公英" />
        <property name="build.file.path" value="release" />
        <property name="build.file.name" value="${project.name}_${git.tag}_r${build.time}" />
        <property name="pgy.description" value="Release${line.separator}Tag:${git.tag} Commit:${git.commit}${line.separator}${git.log}" />
        <!-- 接口服务器地址 -->
        <property name="api.url" value="http://api.release.server.com" />
        <!-- 第三方 Key -->
            <!-- 融云 -->
            <property name="key.rongcloud" value="rongcloud" />
            <property name="key.rongcloud_scid" value="rongcloud_scid" />
        
        <property name="build.file.url" value="http://www.pgyer.com/pgy" />
        <property name="build.file.qrcode" value="http://www.pgyer.com/app/qrcode/pgy" />
    </target>
    
    <target name="config.appstore">
        <property name="project.profile.name" value="appstore" />

        <!-- 构建正式环境配置信息 -->
        <property name="build.type" value="AppStore" />
        <property name="build.config.name" value="正式环境-AppStore" />
        <property name="build.file.path" value="release" />
        <property name="build.file.name" value="${project.name}_${git.tag}_r${build.time}" />
        <property name="pgy.description" value="Release${line.separator}Tag:${git.tag} Commit:${git.commit}${line.separator}${git.log}" />
        <!-- 接口服务器地址 -->
        <property name="api.url" value="http://api.release.server.com" />
        <!-- 第三方 Key -->
        <!-- 融云 -->
        <property name="key.rongcloud" value="rongcloud" />
        <property name="key.rongcloud_scid" value="rongcloud_scid" />
        
        <property name="build.file.url" value="http://download.server.com/IOS/${project.scheme.name}/${build.file.name}.ipa" />
        <!-- 二维码图片接口 -->
        <property name="build.file.qrcode" value="http://qr.liantu.com/api.php?text=${build.file.url}" />
    </target>
    
    <target name="modify">
    <!-- 配置接口服务器地址 -->
        <!-- API Center Url -->
        <replaceregexp byline="true" encoding="UTF-8">
            <regexp pattern='^NSString\s+\*\s+const\s+APIServerUrl\s+=\s+(.*)' />
            <substitution expression='NSString * const APIServerUrl = @"${api.url}";' />
            <fileset dir="ProjectPath/Classes/Main/Other" includes="Const.m" />
        </replaceregexp>
    <!-- 配置第三方 Key -->
        <!-- 融云 Key -->
        <replaceregexp byline="true" encoding="UTF-8">
            <regexp pattern='^#define\s+RONGCLOUD_IM_APPKEY\s+(.*)' />
            <substitution expression='#define RONGCLOUD_IM_APPKEY @"${key.rongcloud}"' />
            <fileset dir="ProjectPath/Classes/Main/Other" includes="Const.h" />
        </replaceregexp>
        <!-- 融云客服 ID -->
        <replaceregexp byline="true" encoding="UTF-8">
            <regexp pattern='^#define\s+CustomerServiceId\s+(.*)' />
            <substitution expression='#define CustomerServiceId @"${key.rongcloud_scid}"' />
            <fileset dir="ProjectPath/Classes/Main/Other" includes="Const.h" />
        </replaceregexp>
        
    </target>
    
    <target name="pack">
        <property name="build.archive.path" value="build/${build.file.path}/${build.file.name}" />
        <!-- pod install-->
        <exec executable="pod" failonerror="true">
            <arg value="install" />
            <arg value="--verbose" />
            <arg value="--no-repo-update" />
        </exec>
        <!-- Clean -->
        <exec executable="xctool" failonerror="true">
            <arg value="-workspace" />
            <arg value="${project.workspace.name}.xcworkspace" />
            <arg value="-scheme" />
            <arg value="${project.scheme.name}" />
            <arg value="clean" />
        </exec>
        <!-- archive -->
        <exec executable="xctool" failonerror="true">
            <arg value="-workspace" />
            <arg value="${project.workspace.name}.xcworkspace" />
            <arg value="-scheme" />
            <arg value="${project.scheme.name}" />
            <arg value="build" />
            <arg value="archive" />
            <arg value="-archivePath" />
            <arg value="${build.archive.path}" />
        </exec>
        <!-- export ipa -->
        <exec executable="xcodebuild" failonerror="true">
            <arg value="-exportArchive" />
            <arg value="-archivePath" />
            <arg value="${build.archive.path}.xcarchive" />
            <arg value="-exportPath" />
            <arg value="${build.archive.path}.ipa" />
            <arg value="-exportFormat" />
            <arg value="ipa" />
            <arg value="-exportProvisioningProfile" />
            <arg value="${project.profile.name}" />
        </exec>
        
        <condition property="isAppStore">
            <equals arg1="${build.type}" arg2="AppStore" />
        </condition>
        <antcall target="copy2share" />
        <antcall target="pgy" />
    </target>
    
    <target name="copy2share" if="isAppStore">
        <!-- 输出文件到指定目录 -->
        <copy file="${basedir}/${build.archive.path}.ipa" todir="/Jenkins/IOS/${project.scheme.name}/" />
    </target>

    <target name="pgy" unless="isAppStore">
    <!-- 发布到蒲公英平台 -->
        <property name="pgy.ukey" value="pgyukey" />
        <property name="pgy.api_key" value="pgyapi_key" />
        <exec executable="curl" outputproperty="pgy.json" failifexecutionfails="true">
            <arg value="-s" />
            <arg value="-F" />
            <arg value="file=@${basedir}/${build.archive.path}.ipa" />
            <arg value="-F" />
            <arg value="uKey=${pgy.ukey}" />
            <arg value="-F" />
            <arg value="_api_key=${pgy.api_key}" />
            <arg value="-F" />
            <arg value="updateDescription=${pgy.description}" />
            <arg value="http://www.pgyer.com/apiv1/app/upload"/>
        </exec>
        <echo message="${pgy.json}" />
    </target>
    
    <target name="wechat">
        <exec executable="date" outputproperty="build.report.time" failifexecutionfails="false" errorproperty="DateError">
            <arg value="+%Y年%m月%d日%H:%M" />
        </exec>
        <!-- corp.media 需要使用永久素材ID -->
        <!--
        wechat.agentid 微信企业号应用id
            wechat.partyid 接收部门ID
            wechat.userid  接收用户ID
        -->
        <property name="wechat.partyid" value="2" />
        <property name="wechat.agentid" value="12" />
        <property name="wechat.userid" value="" />
        <!-- 获取微信API Token -->
        <property name="corp.id" value="wechat_id" />
        <property name="corp.secret" value="wechat_secret" />
        <property name="corp.media" value="wechat_media_id" />
        
        <exec executable="curl" outputproperty="corp.token.json" failifexecutionfails="false">
            <arg value="-s" />
            <arg value="https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=${corp.id}&amp;corpsecret=${corp.secret}"/>
        </exec>
        <!-- <echo message="${corp.token.json}" /> -->
        
        <script language="javascript">
            var jsonString = DJT.getProperty("corp.token.json");
            var json = eval ("(" + jsonString + ")");
            DJT.setProperty("corp.token",json.access_token);
        </script>
        <!-- <echo message="${corp.token}" /> -->
        
        <!-- 发送微信信息 -->
        <property name="build.digest" value="构建完成${line.separator}${ant.project.name}-IOS [${build.config.name}]${line.separator}Tag:${git.tag} Commit:${git.commit}" />
        <property name="build.report" value="&lt;p&gt;构建完成&lt;br/&gt;${ant.project.name}-IOS [${build.config.name}]&lt;br/&gt;${build.report.time}&lt;br/&gt;文件名称&lt;br/&gt;${build.file.name}&lt;br/&gt;Tag:${git.tag} Commit:${git.commit}&lt;br/&gt;更新说明&lt;br/&gt;${build.type}&lt;br/&gt;${git.log}&lt;br/&gt;下载地址&lt;br/&gt;&lt;a href=\&quot;${build.file.url}\&quot; src=\&quot;${build.file.url}\&quot;&gt;${build.file.url}&lt;/a&gt;&lt;br/&gt;&lt;img src=\&quot;${build.file.qrcode}\&quot;/&gt;&lt;/p&gt;" />
        
        <property name="build.report.json" value="{&quot;touser&quot;:&quot;&quot;,&quot;toparty&quot;:&quot;${wechat.partyid}&quot;,&quot;totag&quot;:&quot;&quot;,&quot;msgtype&quot;:&quot;mpnews&quot;,&quot;agentid&quot;:${wechat.agentid},&quot;mpnews&quot;:{&quot;articles&quot;:[{&quot;title&quot;:&quot;Jenkins 构建通知&quot;,&quot;thumb_media_id&quot;:&quot;${corp.media}&quot;,&quot;author&quot;:&quot;Jenkins&quot;,&quot;content_source_url&quot;:&quot;&quot;,&quot;content&quot;:&quot;${build.report}&quot;,&quot;digest&quot;:&quot;${build.digest}&quot;,&quot;show_cover_pic&quot;:&quot;0&quot;}]},&quot;safe&quot;:&quot;0&quot;}" />
        <!-- <echo message="${build.report.json}" /> -->
        
        <exec executable="curl" outputproperty="corp.message.json" failifexecutionfails="false">
            <arg value="-s" />
            <arg value="-l" />
            <arg value="-H" />
            <arg value="Content-type: application/json" />
            <arg value="-X" />
            <arg value="POST" />
            <arg value="-d" />
            <arg value="${build.report.json}" />
            <arg value="https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=${corp.token}"/>
        </exec>
        
        <echo message="${corp.message.json}" />
        
    </target>
</project>