构建iOS持续集成:Jenkins+GitLab+蒲公英和解决中
本文参考博客:
博客一: 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持续集成的一次实践经验。分享给大家,如果里面有什么错误,欢迎大家多多指教。