构建iOS持续集成:Jenkins+GitLab+蒲公英和解决中途遇到的坑

96
我家的小鲤鱼
2016.10.21 15:38* 字数 2124

本文参考博客:

博客一: http://www.jianshu.com/p/c69deb29720d

博客二:http://www.jianshu.com/p/41ecb06ae95f

作为一个优秀的程序猿,每次正开心的在代码世界中遨游的时候,突然测试让你花个十几分钟打个测试包就不爽了,就花了点时间研究了下Jenkins 集成打包,本文主要过程参考上面几篇博客,并重点介绍中途遇到的坑。上正餐吧!!!

JenKins安装

安装的流程就不多说了参考(博客二:http://www.jianshu.com/p/41ecb06ae95f)还是比较详细的,但是我遇到了第一个坑

插件下载

就在这一步下载的时候,基本上最后肯定有几个插件没有下载好,然后就停在这里不动了,不管怎么都不动,然后关机重启才好(估计才开始安装好插件),才跳到(博客二)的注册页面,第一坑就浪费了不少时间。

Jenkins的配置

现在你的电脑上已经有你的Jenkins服务了,就需要安装一些你即将需要的插件如下:(可以装下pod 方面的插件,不知道有没有用,反正我装了。。。)

安装GitLab插件

因为我们用的是GitLab来管理源代码,Jenkins本身并没有自带GitLab插件,所以我们需要依次选择系统管理->管理插件,在“可选插件”中选中“GitLab Plugin”和“Gitlab Hook Plugin”这两项,然后安装。

安装Xcode插件

同安装GitLab插件的步骤一样,我们依次选择系统管理->管理插件,在“可选插件”中选中“Xcode integration”安装。

安装签名证书管理插件

iOS打包内测版时,需要发布证书及相关签名文件,因此这两个插件对于管理iOS证书非常方便。还是在系统管理->管理插件,在“可选插件”中选中“Credentials Plugin”和“Keychains and Provisioning Profiles Management”安装。

安装FTP插件

系统管理->管理插件,在“可选插件”中选中“Publish over FTP”安装。

安装脚本插件

这个插件的功能主要是用于在build后执行相关脚本。在系统管理->管理插件,在“可选插件”中选中“Post-Build Script Plug-in”安装。

好了,插件安装完,可以正式开始自动化构建了!!!


自动化构建

在Jenkins中,所有的任务都是以“item”为单位的。接下来我们就新建一个iOS的项目来开始自动化构建。点击“新建”,输入item的名称,选择“构建一个自由风格的软件项目”,然后点击“OK”。

然后按下图设置构建信息

构建信息

SSH证书配置

然后就遇到源码管理这一步了,由于我们用到的是git管理源码,我们远程拉取代码就需要SSH证书,如果你没有,你就需要配置了,你需要到你的git网页上配置SSH证书参考地址: http://www.jianshu.com/p/60d4fd31b44c

这里用到的是GitLab,先需要配置SSH,我们可以在Jenkins的证书管理中添加SSH。在Jenkins管理页面,选择“Credentials”,然后选择“Global credentials (unrestricted)”,点击“Add Credentials”,如下图所示,我们填写自己的SSH信息,然后点击“Save”,这样就把SSH添加到Jenkins的全局域中去了。

SSH证书

注意到了吗,这一步需要在你的文本框输入你的Key如果你已经配置好了你的SSH证书搜索你的文件 ~/.ssh/id_rsa 这个文件打开复制到上面的文本框就是了


源码管理

接下来,我们再回到刚刚新建的任务中,在源码管理中,选择Git,按下图填好相关信息。

源码管理

注意事项:

1.git地址的选择:要用SSH的,把下面的url部分复制上就可以了

2.上面的 Credentials文本框  选择你刚才创建的SSH

3.Branch Specifier (blank for 'any') 那边就填写你的开发分支如:*/develop1.4.0 

构建环境设置

iOS打包需要签名文件和证书,所以这部分我们勾选“Keychains and Code Signing Identities”和“Mobile Provisioning Profiles”。

这里我们又需要用到Jenkins的插件,在系统管理页面,选择“Keychains and Provisioning Profiles Management”。

进入Keychains and Provisioning Profiles Management页面,点击“浏览”按钮,分别上传自己的keychain和证书。上传成功后,我们再为keychain指明签名文件的名称。点击“Add Code Signing Identity”,最后添加成功后如下图所示:

key设置

这个Keychain其实在/Users/管理员用户名/Library/keychains/login.keychain,当把这个Keychain和Provisioning Profiles上传上去以后,在构建的时候Jenkins会把这个Keychain拷贝到/Users/Shared/Jenkins/Library/keychains这里,(Library是隐藏文件)。Provisioning Profiles文件也直接拷贝到/Users/Shared/Jenkins/Library/MobileDevice文件目录下。上传过程如下:

把你创建的keychain文件拖到上面箭头指的按钮下,点击Upload,密码写你创建的时候的密码

Code Signing Identity  分别写你的测试证书的名字和发布证书的名字

Provisioning Profiles设置

直接到~/Library/MobileDevice/ 目录下面找找看,那个是你准备打包的描述文件,拖到上图箭头所指的按钮上点击Upload。

Provisioning Profiles Directory Path 这个文本框里面写固定路径 :/Users/Shared/Jenkins/Library/MobileDevice/Provisioning Profiles

这样Adhoc证书和签名文件就在Jenkins中配置好了,接下来我们只需要在item设置中指定相关文件即可。

回到我们新建的item,找到构建环境,按下图选好自己的相关证书和签名文件。

集成打包的最后一步了

我们选择的是jenkins给我们提供的Xcode方式打包,没有选择脚本的方式

本人Xcode版本7.3  系统版本 10.11.5。点击上面图中箭头的Xcode,设置要配置的信息

依次填写你的

1.工程 Target名(一般为工程名)。

2.打包方式一般为 Release 

3.打包完成的ipa名称

4.ipa文件存放路径

继续设置

/Users/管理员用户名/Library/keychains/login.keychain,的keychain记住直接找到文件拖到文本框内,不然有可能失效

我打码的部分一般填你的工程名就可以了,或者schema分支名字,然后点击保存就可以了返回主页,点击构建,发现你成功生成了ipa 文件啊,666666

构建project
构建的输出日志

然后就考虑的是把ipa文件上传到蒲公英给测试下载了,然后我试了很多网上提供的脚本,都不太好,然后我惊奇的发现蒲公英的官网竟然给我们提供了jenkins 的脚本,真神奇.....有兴趣的可以去蒲公英官网看看:https://www.pgyer.com/doc/view/jenkins。这里看我的操作吧,如下图,选择增加构建后操作步骤,选择 Execute a set of scripts

然后输入你的脚本,脚本参考地址:http://www.jianshu.com/p/45c3fbc6924a(最后面)

脚本如下:

#蒲公英上的User Key

uKey="xxxxxxxxxxxxxxxx"

#蒲公英上的API Key

apiKey="xxxxxxxxxxxxx"

#要上传的ipa文件路径

IPA_PATH="/Users/Shared/Jenkins/Home/workspace/xxxx/build/xxxxxx.ipa"

#执行上传至蒲公英的命令

echo "++++++++++++++upload+++++++++++++"

curl -F "file=@${IPA_PATH}" -F "uKey=${uKey}" -F "_api_key=${apiKey}" https://www.pgyer.com/apiv1/app/upload

所有配置都已经设置好,点击“保存”,好了,我们可以试试点击“立即构建”按钮了。

SUCCESS!!!

最后

以上就是我关于Jenkins持续集成的一次实践经验。分享给大家,如果里面有什么错误,欢迎大家多多指教。

日记本