iOS：使用jenkins实现xcode自动打包（最新）

参考各种教程实现Jenkins自动化打包遇到点坑，特此把自己成功安装的步骤记录一下。

一.安装jenkins

首先使用osx系统自带的homebrew来安装jenkins。

在终端中运行：

$ brew install Jenkins  

第一步需要安装至少java1.8 ，如果没有安装会有提示，java安装地址

无java时报错

java安装完毕，继续下面步骤，链接 launchd 配置文件

$ 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

一切顺利的话，打开浏览器输入：http://localhost:8080/

就能看到jenkins已经运行起来了，如果你更换了端口就是你后来设置的端口。

接下来打开Jenkins后会让去一个填写password的页面如下图，存储password的地方就是图片上那行红色字体目录下，使用终端 cat + 红色字体路径就看到了

然后将我们得到的password输入到“Administrator password“中，即可进入如下界面，接着安装一些建议的插件（左边的），安装过程中，有的插件可能会安装失败，强烈建议点击右下角的重试，直到把建议安装的都装好。（因为我这边安装之后，在Jenkins插件管理安装插件一直失败，如果这一步没把有些必须的插件装好，如git，只能一个个下载上传插件就很麻烦）

插件安装完成后，可能会卡在如下界面，不会自动跳转，刷新下界面即可：

插件

在刷新后的界面中注册，输入用户名和密码，建议输入后点蓝色按钮保存完成，如下：

注册成功后，点击”Start using Jenkins”

二.jenkins的使用

到这一步，Jenkins的安装基本完成，接下来就是使用了，在新建任务之前需要安装好对应的插件

1.安装插件

Keychains and Provisioning Profiles Management（管理本地的keychain和iOS证书的插件）

Xcode integration （用于xcode构建）

打开系统管理，管理插件详见图

安装方式：

方案一：在可选中搜索插件名 ，勾选安装。若安装报错（参照安装Jenkins时不能联网安装插件问题解决），如果还不行，直接进入方案二。

方案二：去Jenkins-plug官网下载插件，然后选择高级tab，上传.hpi文件

2.配置Keychains and Provisioning Profiles Management

接下来配置Keychains and Provisioning Profiles Management，根据顺序选择首页>系统管理>Keychains and Provisioning Profiles Management如图

需要上传login.keychain文件，该文件获取方法，在终端中输入

cd ~/Library/Keychains

在终端键入ls详见下图

将login.keychain文件upload之后，会出现下图的界面，根据需要将证书添加进去即可，但是由于macOS10.12以及以后的系统里面没有login.keychain文件，只有login.keychain-db,可以复制出来删除-db，也可以创建一个快捷方式名字叫做login.keychain，upload就好了。（上传keychain，路径用自己改名后的那个）

然后添加Provisioning Profiles，上传方法和上传login.keychain一样，去选择Provisioning Profiles文件，然后upload，然后结果如下图，蓝色框内的是固定格式的/Users/用户名/Library/MobileDevice/Provisioning Profiles

3.开始配置任务

然后创建一个任务，自由风格的任务，因为构建方法会有两种,除了共同的地方，构建会分为两部分解答，第一部分是macOS10.12以前的构建方法，但是由于Jenkins的Xcode和Mac的系统版本问题，所以建议使用第二种方法。

General

创建一个自由风格的任务，然后在选择丢弃旧的构建，至于天数和保持的最大个数，按照自己的需求来就好，如图

源码管理

接下来是源码管理，在Repository URL里面添加你的git地址，我这里添加的是http的，如果你的项目是使用的ssh的，那么就将git开头的地址填写上，然后店家Add添加你的git帐号，如果你的事ssh的，将ssh的密匙填写上，具体的自己百度一下就好咯，我就不多写了，结果如图

构建触发器

接下来是构建触发器，也就是什么时候触发自动打包我这里填写的是H 20 * * *这个意思就是H小时然后，后面跟着数字，在后面就是日月年，*代表的我认为是每次都触发，也就是每天每月每年，但是Jenkins的时间不是绝对的，一般都是在随机在半点，也就是设置20点，大概会在20:30分左右会触发，如果需要两个时间，那么格式可以这样H 20,22 * * *结果如图

构建环境

在构建环境里面勾选Keychains and Code Signing Identities和Mobile Provisioning Profiles，Keychains and Code Signing Identities是打包需要的证书，Mobile Provisioning Profiles是打包需要的配置文件，都是可以自己选择的，我的如图14

接下来就是构建了，因为Jenkins对新版的Xcode插件兼容不好，只能用脚本来打包，但是老版本的Xcode可以使用Jenkins的Xcode插件，下面将构建一为使用Xcode插件的，构建二是脚本的

构建一，使用Xcode插件

在构建里面点击增加构建步骤，然后点击Xcode.

General build settings

在Target里面填写你的项目名称，Clean before build勾选YES，勾选Pack application, build and sign .ipa?，然后会有新的选项Export method是你要打的包的类型，就是你在手动打包的时候选额的ad-hoc或者Appstore那四个选项，这个按照你要打的类型填写，.ipa filename pattern是你打出包ipa的名字，我的这里填写了项目名字和-$(BUILD_DATE)，意思就是在后面追加时间，Output directory是导出ipa的目录，如果不填写，会在Jenkins默认的目录.

详见图

Code signing & OS X keychain options

勾选Unlock Keychain?,在Keychain path那里填写${HOME}/Library/Keychains/login.keychain,意思是找到你的login.keychain（登陆钥匙串），如果你的是复制出来改的名字，那么就填写你相对应的目录，Keychain password就是你电脑的登陆密码。详见图

Advanced Xcode build options

勾选Clean test reports?，如果你使用了cocoapods那么填写Xcode Workspace File，如果没有使用cocoapods填写Xcode Project Directory，然后填写Build output directory就是你到处ipa的路径,详见图

完成之后，回到任务操作页面，点击立即构建，如果配置没问题基本就能构建成功

构建进行中

偶尔会出现报错，点击任务编号，也就是上图的#4#5#6，然后进入任务详情页，进入控制台输出看看哪里出了问题，我之前是报了profile文件不匹配的error（target填错了），然后改了就好了

控制台输出log

成功，小太阳出来了

对应目录生成了文件，所生成的内容也是需要自己选择配置的

构建二，使用脚本（蒲公英上传请参考https://www.jianshu.com/p/6bab38e569a5）

因为Jenkins对现在的Xcode9插件兼容性不好，打不了包，所以我们使用了xcodebuild打包，下面是我的脚本，并且里面附上了自己非常详细的注释，可能有点啰嗦。

#!/bin/sh  #因为Jenkins打包可能是自动的，那么build号是不会自己再去修改然后push到git上面的，所以这个buildPlist就是修改build号的路径。 buildPlist="/Users/apple/.jenkins/workspace/longxin_a/eCloud/Build/LongHu/Config/eCloud-Info.plist"  #这个获取现在的 月日时分 用它来做build号 buildNumber=$(date +"%m%d%H%M")  #修改plist文件需要/usr/libexec/PlistBuddy -c命令，CFBundleVersion是修改的这个build号，$buildNumber是你要修改的数值，$buildPlist是你修改哪个地方的plist文件。 /usr/libexec/PlistBuddy -c "Set :CFBundleVersion $buildNumber" "$buildPlist"  #这个是获取当前的build号，本来是用来看看有没有修改成功的 #newBuildName=$(/usr/libexec/PlistBuddy -c "print :CFBundleVersion" "$buildPlist") #这个是打印，带自动换行的打印 echo $newBuildName  #因为我怕他修改plist的时候需要时间，所以索性在这里我让他等了3秒，当然你也可以去掉 sleep 3  #这个buildPath是到时候我生成xcarchive文件的路径和打ipa时候需要找到xcarchive的路径 buildPath="/Users/apple/.jenkins/workspace/longxin_a/build/Release-iphoneos/eCloud.xcarchive"  #这个路径是我生成ipa的路径 ipaPath="/Users/apple/Documents/longhuBuild/"  #这个是ExportOptions.plist的路径，有这个就不用在用脚本写证书了，这个plist你只要手动打过包，那么在生成ipa的文件夹里面就会有，找一个自己不经常修改的地方放在那里，写上这个路径就好，当然如果你不想这么做，想用shell语言设置证书，我会在 问题 列表里面有介绍 exportOptionsplistPath='/Users/apple/.jenkins/workspace/ExportOptions.plist'  #因为我使用了cocoapods所以这里用的-workspace，如果你没有使用cocoapods使用-project，下面的命令都一样 #这个命令主要是用来clean，clean的是Release的路径，clean的是/Users/app***eCloud.xcworkspace路径的eCloud， xcodebuild -workspace /Users/apple/.jenkins/workspace/longxin_a/eCloud.xcworkspace -scheme eCloud -configuration "Release" clean  #这个是生成xcarchive，Release的 xcodebuild -workspace /Users/apple/.jenkins/workspace/longxin_a/eCloud.xcworkspace -scheme eCloud -archivePath ${buildPath} -configuration "Release" archive  #这个是将xcarchive文件打包成ipa xcodebuild -exportArchive -archivePath ${buildPath} -exportPath ${ipaPath} -exportOptionsPlist ${exportOptionsplistPath} -allowProvisioningUpdates

邮箱通知

到这里，其实你就已经打包成功了，但是打包成功后是不是我们需要通知一些人呢？Jenkins是有邮件通知的。

现在开始设置，首先你已经安装了插件Email Extension Plugin，这个在插件那里直接安装就好这是第一步；

然后进入系统管理->系统设置找到Jenkins Location模块，在系统管理员邮件地址填写你的系统管理邮箱，这个邮箱是你发送通知邮件的邮箱，

然后找到Extended E-mail Notification模块

填写方法如图18图19

图18 图19

然后找到构建后操作，点击增加构建后的操作步骤点击Editable Email Notification，在Project From里面写上管理者邮箱，也就是发送邮件的邮箱，然后点击Advanced Setting;

里面有三个选项，分别是你在系统设置里面勾选的那几个，根据需求填写就好，我这里填写的是Always，也就是无论构建成功还是失败,Recipient List是接收者的邮箱，这里多个邮箱用英文逗号隔开——’,’详见图20

图20

上传到fir

先去下载fir插件

然后在Jenkins里面点击系统管理->管理插件->高级，然后滑动到上传插件那里，选择刚才下载的插件，点击上传，等待上传成功后，进入到你的项目配置里面滑动到最下面，也就是找到构建后操作，点击增加构建后操作步骤，选择Upload to fir.im，打开你的浏览器，打开fir官方网站,获取方法见图21

21的

然后输入你的IPA/APK Files (optional)这个是你ipa的路径，如果不选择，会是Jenkins默认的路径

这里有fir的官方文档，根据fir的官方文档即可就可以Jenkins上传到fir文档

到此为止关于Jenkins整合Xcode的配置项并自动上传到蒲公英差不多就说好了。那么可以稍微构建一下项目试试了，构建完项目后，你就会发现测试人员不需要天天来烦你，再也不需要听到“开发狗，赶紧给我安装一个最新的版本”了。

各位可能会用到的友情链接：

jenkins 密码错误去掉密码登录(mac路径为/Users/用户名/.jenkins)

Jenkins 修改登录密码

Jenkins 卸载

参考教程：

http://blog.csdn.net/u014641783/article/details/50866196

https://blog.x1be.win/index.php/2018/06/19/jenkins%E5%AE%89%E8%A3%85%E3%80%81%E9%85%8D%E7%BD%AE%E3%80%81%E6%9E%84%E5%BB%BA%E3%80%81%E8%84%9A%E6%9C%AC%E3%80%81%E9%85%8D%E7%BD%AE%E9%82%AE%E7%AE%B1%E3%80%81%E4%B8%8A%E4%BC%A0fir/