Jenkins+Xcode+fir.im 自动化打包
JenKins配置
1.安装Jenkins
安装Jenkins有两种方式:
1. 使用终端安装
使用系统自带的homebrew来安装Jenkins,在终端中运行:
$ brew install Jenkins
因为Jenkins是使用Java写的,所以我们需要先安装JDK,jdk安装地址
接着链接launch配置文件
$ ln -sfv/usr/local/opt/jenkins/*.plist ~/Library/LaunchAgents
//如果要其他机器也可以访问,把ip地址改为广播地址:--httpListenAddress=0.0.0.0
$ launchctl load~/Library/LaunchAgents/homebrew.mxcl.jenkins.plist
如果端口号冲突了,需要修改Jenkins的端口号
启动Jenkins
$ jenkins
2. 在Jenkins官网上下载安装
在Jenkins官网下载安装
我选择的是 Mac OS X
下载完成后,取消 "Start at boot as jenkins", 一般不需要自启动,点击安装
如果没有报错的话,此时终端会开启一个Jenkins的服务,<span>不要关闭这个</span>,然后在浏览器打开 http://localhost:8080,现在就可以看到Jenkins已经运行起来了,如果你更换了端口号,就将8080替换为你的端口号。
2.Jenkins的初始化
第一次进入Jenkins的界面后,需要填写一些必要的配置信息:
-
在提示的路径下找到默认密码,然后复制粘贴到这个地方,continue
-
安装一些插件,选择第一个
这个过程可能会有些慢,耐心等待下。。。
-
创建用户名和密码
注册成功后,点击 "Start using Jenkins"
3.Jenkins的使用
在新建任务之前需要先安装一些必要的插件
Keychains and Provisioning Profiles Management (管理本地keychain和iOS证书的插件)
Xcode integration (用于构建Xcode)
<del>对于keychain这个插件,暂时不确定有没有用,参考其他的文档弄来弄去,最后配置完成后又uninstall了,还是打包成功了😑。 后面验证下如果不安装这个插件可不可以打包成功</del>
其实这个还是需要的,因为打包后设备不能安装,所以需要使用这个插件读取provision文件
插件的安装有两种方式:
1. 在管理插件页面下载安装
打开系统管理-》管理插件:
搜索需要安装的插件,安装后重启Jenkins
2. 在Jenkins-plug官网下载插件,然后在管理插件页面选择高级,上传.hpi文件
配置Keychains and Provisioning Profiles Management
如果安装了这个插件,在系统管理页面选择 Keychains and Provisioning Profiles Management
需要上传login.keychain文件,获取文件的方法
cd ~/Library/Keychains
ls
可能系统里面找不到login.keychain文件,我的就没有,不过我们可以创建一个文件,名字就叫login.keychain 也是可以的,然后上传,填入电脑的密码
4.创建项目
点击 "New 任务"
接下来填写一些配置信息
-
General
-
Source Code Management
-
Build
点击 "Add build step",选择Xcode
获取Targets的命令, cd到项目路径
$ xcodebuild -list
如果是打包给测试人员使用,Configuration建议使用Debug,其他的都是默认设置
这里如果本地的Xcode证书都配置好了,Code signing & OS X keychain options 选项就不用填了
刚开始的时候看其他文档,都需要配置这里,弄了好久,打包都失败了,最后发现我用Xcode打包也是失败的,因为我没有将证书和描述文件下载下来 ̄□ ̄||
项目中如果使用xcworkspace启动,就在Xcode Workspace File 栏里面填入文件路径,注意需要将后缀删掉
5.Finally
到这里一切正常的话,就可以正常运行了
点击"立即构建",等待Jenkins构建工程,如果没有问题的话是这样的
失败的话,点击这一项-》Console Output,查看具体的原因,然后再做修改。
Xcode配置
在本机上安装好证书和描述文件,然后在Jenkins网站上配置代码地址
先在Xcode上测试一下可以不以导出IPA包,不然的话就在Jenkins上打包一直都不成功,然后还找不到原因。
Fir.im配置
成功导入IPA包后,上传到fir.
首先下载fir插件 插件地址
然后再Jenkins里面点击 系统管理-》插件管理-》高级,然后上传插件
上传成功后,到项目配置里面,拖到最下面,添加 "Add post-build action",选择 "Upload to fir".
上传fir.im Token
在这里fir.im获取token
然后填写进去
IPA/APK Files(可选)
如果没有填写,插件会自动到Jenkins创建的目录下寻找
如果我们是自定义路径,需要填写路径,注意:路径只需要填写到上层文件夹即可即如果你的IPA文件路径是.../项目文件夹名/ipa文件夹名/xxx.ipa,只需要填写到.../项目文件夹名/
现在再次构建项目,如果一切正常的话,应该就可以在fir上看到新上传的文件了。
这里我导出IPA的路径是自定义的,然后上传到fir的时候找不到文件,目前还不知道是什么情况,待解决!!!
构建成功了
邮件通知
在插件管理页面搜索 "Email Extension",安装插件,然后进入系统管理-》系统设置页面,如下:
最下面有一个邮件配置,这个是系统默认的,我们可以用这个来测试邮件是否能发送成功。
这个是配置成功后的截图
然后我们找到 "Extended E-mail Notification",也就是我们装完插件后的配置.
!!!注意:接收邮件的地址应该写在 "Default Recipients",截图上写错了
往下拉,点击 "Default Triggers",这里勾选发送邮件的时机
另外,我在重新进入到系统设置中后,发现这里有个黄色警告
然后我把下面的地址改为发送邮箱地址,不确定这个会不会影响邮件发送,还是设置一下为好。
然后回到项目配置里面,找到构建后的操作,点击增加构建后的操作步骤,点击 "Editable Email Notification"
这里面基本上都是默认配置。
需要注意的是
这里是接收者邮箱,如果没有填的话会从上面的邮箱配置里面读取。
获取SVN或git提交日志上传到fir
在fir的配置里面,上传日志的地方只能手写,但是这样就违背了自动构建的初衷,所以还是想要能够自动读取日志上传到fir,还好在网上找到了解决办法。
下载插件地址
上传插件到Jenkins就不写了,上面有。
然后我们在项目配置里面找到这里
Entry Format中添加 %3$s(at %4$s via %1$s)\n
Date Format中添加 yyyy-MM-dd
在fir提交日志的地方使用SCM_CHANGELOG获取 ${SCM_CHANGELOG}
上传到App Store
上传到App Store上找了下资料,然后弄了下,没搞懂,等下次发版本的时候在弄一下吧
最后
第一次接触Jenkins,感觉好强大,还有到多地方不懂,以后是时间再好好研究一下。
参考文章:
https://www.jianshu.com/p/3668979476ad
https://www.jianshu.com/p/d8c48fcf695b
https://blog.csdn.net/tianxiawoyougood/article/details/71483306