gitlab+jenkins自动化打包IOS-jenkins配置

实现的效果如图： 

• 构建界面：

• 完成效果：

功能说明：

• 根据选择的代码分支，执行构建打包
• 构建成功后根据ipa/apk生成二维码，并可在历史构建列表中展示各个版本的二维码，通过手机扫描二维码可直接安装对应版本

因为搭建平台写了一系列博文，这里作一个总结与整理

首先jenkins需要的插件：

• build-name-setter：用于修改Build名称
• description setter plugin：用于在修改Build描述信息，在描述信息中增加显示QRCode（二维码）
• Build Name and Description Setter

• Git Parameter 参数化构建分支

具体的配置：

1.MAC搭建jenkins

• 注意：直接下载war包, 不要下载Mac OS X,

参照：MAC 安装jenkins

Tips：

最好是把jenkins.war包放在tomcat中运行，这样比较方便配置开机自启动，

如果使用java命令启动jenkins,每次开机都要使用命令去启动会很麻烦

2.jenkins创建测试job

3.配置与gitlab连接，别忘记在jenkins宿主机配置gitlab的host

在Repository URL处：输入仓库地址，这里选择http方式：

添加用户名，密码

点击【保存】，执行构建，查看日志可以看到commit message，说明git已经与jenkins连接成功了

 > git fetch --tags --force --progress http://git.xxxx.com/kaifa/testcase.git +refs/heads/*:refs/remotes/origin/*
 > git rev-parse refs/remotes/origin/master^{commit} # timeout=
 > git rev-parse refs/remotes/origin/origin/master^{commit} # timeout=
Checking out Revision 724dd42afc5ecd9b92842681cd85c2da6992ddda (refs/remotes/origin/master)
 > git config core.sparsecheckout # timeout=
 > git checkout -f 724dd42afc5ecd9b92842681cd85c2da6992ddda
Commit message: "aa"
First time build. Skipping changelog.
Finished: SUCCESS

另外要注意：

　　在Jenkins的默认配置中，clone代码时会拉取所有历史版本的代码，而且默认的超时时限只有10分钟。这就造成在某些项目中，由于代码量本身就比较大，历史版本也比较多，再加上网络环境不是特别好，Jenkins根本没法在10分钟之内拉取完所有代码，超时后任务就会被自动终止了（错误状态码143）。

　　这种问题的解决方式也很简单，无非就是两种思路，要么少拉取点代码（不获取历史版本），要么提高超时时限。对应的配置在Advanced clone behaviours中：

• Shallow clone：勾选后不获取历史版本；
• Timeout (in minutes) for clone and fetch operation：配置后覆盖默认的超时时限。

4.构建-打包脚本 

 ## !/bin/sh
 ## 项目名
 TARGET_NAME="XXXXAPP"
 ## xcworkspace文件所在目录
 TARGET_PATH="XXXXWorkspace/XXXXAPP"
 ## Scheme名
 SCHEME="XXXXAPP"
 ##=======================
 ## 编译类型
 BUILD_TYPE=${ENV}
 ## 当前目录
 SORCEPATH=${WORKSPACE}
 ## workspace名
 SPACE=${WORKSPACE}/${TARGET_PATH}/${TARGET_NAME}.xcworkspace
 ##xcarchive文件的存放路径
 ARCHIVEPATH=$SORCEPATH/build/$SCHEME.xcarchive
 ## ipa文件的存放路径
 EXPORTPATH=$SORCEPATH/build/$SCHEME
 ## ExportOptions.plist文件的存放路径
 EXPORTOPTIONSPLIST=$SORCEPATH/build/ExportOptions.plist
 ## 导出后的ipa路径
 EXPORTPATHIPA=$SORCEPATH/build/$SCHEME/$SCHEME.ipa

 echo -e "============First Build Clean============"
 ## 清理缓存
 xcodebuild clean -workspace $SPACE -scheme ${SCHEME} -configuration ${BUILD_TYPE}

 echo -e "============Build Clean============"
 ## 输出关键信息
 echo -e "  TARGET_NAME    : ${TARGET_NAME}"
 echo -e "  BUILD_TYPE    : ${BUILD_TYPE}"
 echo -e "  SORCEPATH    : ${SORCEPATH}"
 echo -e "  ARCHIVEPATH    : ${ARCHIVEPATH}"
 echo -e "  EXPORTPATH    : ${EXPORTPATH}"
 echo -e "  EXPORTOPTIONSPLIST    : ${EXPORTOPTIONSPLIST}"

 echo -e "============Build Archive============"

 ## 导出archive包
 xcodebuild archive -workspace ${SPACE} -scheme ${SCHEME} -archivePath ${ARCHIVEPATH}  -configuration ${BUILD_TYPE}

 echo -e "============Build Archive Success============"

 echo -e "============Export IPA============"

 ## 导出IPA包
 xcodebuild -exportArchive -archivePath ${ARCHIVEPATH} -exportPath ${EXPORTPATH} -exportOptionsPlist ${EXPORTOPTIONSPLIST}

 echo -e "============Export IPA SUCCESS============"

 ## 编译完成时间 20181030_0931
 BUILD_DATE="$(date +'%Y%m%d_%H%M')"

 ## info.plist路径
 PROJECT_INFOPLIST_PATH="${SORCEPATH}/${TARGET_PATH}/${TARGET_NAME}/Info.plist"
 ## 取版本号
 BUNDLESHORTVERSION=$(/usr/libexec/PlistBuddy -c "print CFBundleShortVersionString" "${PROJECT_INFOPLIST_PATH}")
 ## 取build值
 VERSION=$(/usr/libexec/PlistBuddy -c "print CFBundleVersion" "${PROJECT_INFOPLIST_PATH}")
 ## ipa更名规则  项目名V版本_年月日_时分
 IPANAME="${TARGET_NAME}V${BUNDLESHORTVERSION}_${BUILD_DATE}.ipa"
 ## 更名后ipa路径
 EXPORTPATHNEWIPA=$EXPORTPATH/$IPANAME

 echo -e "============Export end :${BUILD_DATE}============"
 echo -e "============IPA Old Name: ${EXPORTPATHIPA}============"
 echo -e "============IPA New Name: ${EXPORTPATHNEWIPA}============"

 ## IPA更名
 cp $EXPORTPATHIPA $EXPORTPATHNEWIPA

 echo -e "============Create New Name Success============"

 ## 删除老IPA
 ##rm $EXPORTPATHIPA

 ##echo -e "============Delete Old Name Success============"

执行脚本，如果在执行pod update 时报错 pod: command not found

/Library/Tomcat8/temp/jenkins1548742361760571620.sh: line : pod: command not found
Build step 'Execute shell' marked build as failure

解决办法看这里：https://www.jianshu.com/p/3ef37b9538bf

解决办法是：

出现这个问题可能是因为你没有设置pod的运行路径，解决方法如下
第一步：打开Jenkins，然后在Jenkins左侧的菜单中找到 系统管理--->系统设置--->全局属性，然后找到Environment variables（中文：环境变量）并且勾选。
第二步：打开你的终端，在终端中输入echo $PATH,终端会打印出一串字符串，几个路径，复制该路径，返回到Jenkins中
第三步：会让填写一个键值对，键默认填写PATH，值填写你从终端复制的那个字符串，点击保存，完成，构建该项目。

 5.将ipa文件上传蒲公英

参照：

pytho脚本－上传apk至蒲公英

6.构建成功，在构建历史中展示二维码

jenkins插件set build description使用规则

7.收集编译成功物

每次完成构建后，编译生成的文件较多，但是并不是所有的文件都是我们需要的。

通常情况下，我们可能只需要其中的部分文件，例如.ipa/.app/.plist/.apk等，这时我们可以将这部分文件单独收集起来，并在构建页面中展示出来，以便在需要时进行下载。

要实现这样一个功能，需要在【Post-build Actions】栏目中新增Archive the artifacts，然后在Files to archive中通过正则表达式指定成果物文件的路径。

设置完毕后，每次构建完成后，Jenkins会在Console Output中采用设定的正则表达式进行搜索匹配，如果能成功匹配到文件，则会将文件收集起来。

8.自定义build名字

　　在Build History列表中，构建任务的名称默认显示为按照build次数递增的BUILD_NUMBER。有时候我们可能想在build名称中包含更多的信息，例如包含当次构建的SCHEME和CONFIGURATION，这时我们就可以通过修改BuildName实现。

　　Jenkins默认不支持BuildName设置，但可通过安装build-name-setter插件进行实现。安装build-name-setter插件后，在配置页面的Build Environment栏目下会出现Set Build Name配置项，然后在Build Name中就可以通过环境变量参数来设置build名称。

　　例如，要将build名称设置为上面截图中的StoreCI_Release_#130样式，就可以在Build Name中配置为${SCHEME}_${CONFIGURATION}_#${BUILD_NUMBER}。

除了在Build Name中传递环境变量参数，build-name-setter还可以实现许多更加强大的自定义功能，大家可自行探索。

如果想在buildName中加入启动构建的用户名，可以参照Jenkins获取运行job的用户名

9.通过git parameter动态选择仓库中的分支进行打包

参照：

jenkins-参数化构建(三)插件：Git Parameter

https://www.cnblogs.com/zhaojingyu/p/9862443.html

遇到的问题及解决办法：

搭建jenkins:

初次打开jenkins页面一片空白的解决办法

其它配置：

JENKINS针对不同项目组对用户进行权限分配

感谢大佬：

提供了很多思路：

https://debugtalk.com/post/iOS-Android-Packing-with-Jenkins/