Jenkins iOS持续集成实现

前言

Jenkins是一个开源的持续集成工具，支持各种软件的持续集成。但是iOS项目的编译打包依赖于Xcode，不幸的是Linux服务器无法安装Xcode。所以只能通过Jenkins节点，将一台Mac作为slave来实现Linux上的iOS项目构建。

环境

master: Mac OS 10.14.4
slave: Mac OS 10.14.2
Jenkins: 2.17.4

接着添加描述文件，描述文件的地址一般是 /Users/xxx/Library/MobileDevice/Provisioning Profiles。Filename为文件名切不可修改，所以如果想要有可读性的话可以先修改成自己想要的名字再上传，例如“project name_distribution”。只要路径文件夹里有以对应UUID命名的文件就行。

上传描述文件

上传完描述文件需要把MobileDevice文件夹复制到Jenkins的Library目录下，对应路径/Users/Shared/Jenkins/Library/MobileDevice/Provisioning Profiles。
否则会提示下图所示的错误

报错找不到对应的描述文件

如果出现下图所示的java.nio.file.AccessDenieException报错，一般是因为对应的路径Jenkins没有读取权限所造成的

权限错误

三、节点创建

1.配置 MacOS Slave

在slave机器上新建一个普通成员权限的用户jenkins,然后登录jenkins用户。
登录后在系统偏好设置 > 共享中开启远程登录，添加远程登录Jenkins用户

开启远程登录
还有很重要的一点，在slave机器上安装对应的证书和描述文件，因为最终打包是在slave机器上执行的，所以也要安装对应的证书和描述文件。

2.创建节点

选择固定节点

远程工作目录：在slave电脑上登录jenkins后新建一个文件夹，位置任意，只要有权限就可以。
标签： 填写一个惟一的字符串
主机： slave机器的ip地址
Credentials： jenkins账号的账号密码，没有就添加一个

节点配置

保存后启动节点，看到类似下图的信息就成功了。

安装节点

四、任务创建

image.png

任务创建成功后进入配置

进入配置

设置项目在节点运行，输入之前创建的节点的标签

设置项目的运行节点

项目是托管在gitlab的，所以这里选择Git
输入仓库的ssh地址，Credentials选择之前上传的SSH Private Key

image.png

每隔2分钟轮询一次git，如果有更新就开始构建，也可以添加定时构建。

构建触发

配置证书和描述文件

接下来就是最重要的打包脚本了

添加shell脚本

首先是拉取Cocoapods 和 Carthage的依赖，如果你只用了其中的一种删掉另外一行代码就行了。如果都没有的话请忽略这一步

拉取依赖

打包脚本

通过PlistBuddy 从info.plist中获取版本号和build number，用于ipa的名称。
将ipa的路径存入文件，等会上传到蒲公英的时候需要用到。
打包前先clean一下。
通过xcodebuild 执行archive，图中的脚本是集成了cocoapods的脚本。下面是没有继承cocoapods的clean和archive脚本：

echo "+++++++++++++++++ clean +++++++++++++++++"
xcodebuild -target "${TARGET_NAME}"  -configuration 'Release' clean

echo "+++++++++++++++++ Archive +++++++++++++++++"
xcodebuild -target "${TARGET_NAME}"\
 -sdk iphoneos -configuration 'Release'\
 CODE_SIGN_IDENTITY="${CODE_SIGNING_IDENTITY}"\
 SYMROOT='$(PWD)'\
 archive -archivePath ${WORKSPACE}/builds/${IPANAME}/${APP_NAME}.xcarchive

最后导出xcarchive文件成ipa包，并输出到指定的文件夹

到此一个iOS工程的Jenkins打包就配置好了。

五、添加上传脚本

现在已经有打包后的ipa包了，最后再上传到蒲公英就可以交付给测试了

1. 先安装fir-clifir命令行工具

gem install fir-cli

2. 添加上传脚本

# 蒲公英的User Key
uKey="******"
# 蒲公英的API Key
apiKey="******"

# 要上传的ipa文件路径
IPA_PATH=$(cat path.txt)

rm -rf path.txt

# 上传至蒲公英的命令
echo "++++++++++++++ 上传至蒲公英... +++++++++++++"
curl -F "file=@${IPA_PATH}" -F "uKey=${uKey}" -F "_api_key=${apiKey}" http://www.pgyer.com/apiv1/app/upload

至此整个iOS项目的自动化打包集成就完成了。

六、总结

整个流程走通还是不容易，笔者也是踩了不少坑，花了好几天的时间才完成整个流程。第一次是直接在自己的MacBook上打包，第二次是将一台iMac作为slave打包，两个流程都走了一遍，其实走完第一个再来第二次就很容易了。写这篇文章主要也是记录下踩坑的过程，方便后面自己回顾，也让其他的同学可以走的顺利一点，可能还是会有其他的问题，可以参考下面的链接。

参考链接

手把手教你利用Jenkins持续集成iOS项目
jenkins iOS自动化打包分发
iOS开发-自动化打包Jenkins集成
Jenkins部署MacOS Slave实现持续集成(iOS)

Jenkins iOS持续集成实现

前言

环境

目录

一、Jenkins安装

二、Jenkins环境配置

1. 安装插件

2. 添加SSH私钥

3. 添加描述文件及证书