Jenkins+xcodebuild+fir持续集成踩过的坑（Mac）

下载安装Jenkins（Mac）

Jenkins 是基于 Java 开发的，所以需要先安装 Java 环境。然后去 Jenkins 官网下载 Jenkins.pkg 安装包安装。也可以用 Homebrew 安装。具体安装步骤可以参考这个链接的内容(在High sierra系统下，这篇文章中的使用插件来构建项目的操作已经失效了，可以参考原作者文章底部的脚本构建方法)：
手把手教你利用Jenkins持续集成iOS项目

安装过程值得注意的地方：

• 安装完成后，会自动打开 http://localhost:8080 这个地址，如果没有自动打开，请手动打开。接下来会有个重设 Jenkins 密码的界面，提示给出了密码文件的路径，我假设为：/Users/Shared/Jenkins/Home/secrets/initialAdminPassword。 你可以修改./secrets 这个文件夹的访问权限，然后打开。如果仍然打不开的话可以在终端尝试用：cat /Users/Shared/Jenkins/Home/secrets/initialAdminPassword 这个命令来查看。
• 安装完成会自动创建一个叫 Jenkins 的用户，这个用户有什么作用我还不清楚。
• 部分教程说接下来的步骤是去“系统管理-管理插件”菜单安装一些插件。我的这个教程是使用 Xcodebuild 脚本打包的，所以不需要以下的插件：Xcode integration 、Keychains and Provisioning Profiles Plugin。

新建一个项目

• 选择“构建一个自由风格的软件项目”。其中 General 选项的配置没有什么坑，可以参照大多数的教程来做。
• 源代码管理，只要你的项目管理软件核心使用的是 git，那么这里都可以选择 git 。我以 GitHub 为例，使用用户名密码来获取项目，首先创建一个 Jenkins 的新的证书，也就是类似于账户的东西：

jenkins_add_credential

也有一些公司的 Bitbucket 、 gitlab 项目仓库存在一些个性化权限设置，如果用户名密码方式失败的话，可以考虑试试SSH登录。

jenkins_source-01

“构建触发器”这个选项可以略过，不用选择任何选项

• 构建触发器，这个配置可以自动触发 Jenkins 打包，也是自动化构建的必须步骤，配置没有什么复杂的，照着教程设置就可以了。我认为第一次配置 Jenkins 的难点在于第一次构建成功，如果第一次手动构建成功了，后续再完善其他配置都水到渠成，所以我建议一开始配置的时候略过“构建触发器”选项，不影响手动构建iOS项目。附上构建触发器的配置教程：构建触发器详解

“构建环境”这里有坑

• 之前有很多教程让下载 Keychains and Provisioning Profiles Management 插件，然后在此插件中上传 keychain 和 provisioning file 。坑来了，我是 High Seirra + Xcode9.2 的环境，所以我的Mac中没有一个叫 login.keychain 的文件，直接上传 login.keychain-db 的话，这个插件不识别。有的说改名可以，不过我懒得测试了，总之，我放弃了使用这个插件，我选择使用xcodebuild脚本构建。所以我的方案是，“构建环境”这个选项都忽略掉，不用任何设置。

“构建”使用xcodebuild脚本

直接使用xcodebuild构建，关于xcodebuild的基本语法可以参考以下教程：

官方文档

xcodebuild使用总结

xcodebuild构建

xcodebuild clean -project JenkinsDemo/JenkinsDemo.xcodeproj \
                 -scheme JenkinsDemo \

ArchivePath="/Users/shawn/Desktop/JenkinsDemo.xcarchive"
xcodebuild archive  -project JenkinsDemo/JenkinsDemo.xcodeproj \
                    -sdk iphoneos \
                    -scheme JenkinsDemo \
                    -archivePath "${ArchivePath}" \
                    -configuration Debug \

ExportPath="/Users/shawn/Desktop/JenkinsDemo"
ExportOptionsPlistPath="/Users/shawn/Desktop/ExportOptions.plist"
echo "+++++++++++++++++ exportArchive +++++++++++++++++"
xcodebuild -exportArchive -archivePath ${ArchivePath}\
                          -exportPath  ${ExportPath}\
                          -exportOptionsPlist ${ExportOptionsPlistPath}\
                          -configuration Debug \

ipa_path="/Users/shawn/Desktop/JenkinsDemo/JenkinsDemo.ipa"
fir_token="a4a513de2bcd6064a7d******0855378"
fir publish ${ipa_path} -T ${fir_token}

• 此时点击构建可能会报如下图的错误，提示证书没有找到：

证书错误

• 这时候需要打开 keychain 助理，把“登录”选项下的你打包需要的证书，拖到“系统”选项下，正常的话输入两次管理员密码就可以了。

移动证书到系统

• 如下图是不正常的情况，如果拖拽证书的过程中遇到这样的错误，请重启一次电脑，再操作就可以了。我也不知道原因。

移动证书时发生错误

• 证书移动完毕，应该可以构建成功了。关于 fir 自动上传的脚本，你可以搜索一下，很简单的。

手动构建成功后，表示基本功能已经完成，后续可以完善其他配置

• 配置构建触发器 http://www.cnblogs.com/caoj/p/7815820.html

• 配置fir/蒲公英自动上传。如果提示 fir 命令没找到，那么需要修改一下Jenkins的环境变量：
  系统管理->系统设置->环境变量（environment path）

  
  
  

  jenkins_environment_path

• 配置构建后邮件通知 http://blog.csdn.net/fullbug/article/details/53024562

关于Jenkins

在这个持续集成的方案里，Jenkins的主要职责是随时监听代码仓库的变动，一旦代码仓库改动，满足打包要求，就触发自动构建。自动构建的具体实施是依靠 xcodebuild 脚本来实现的。之前有大神做了一下插件来封装了这些脚本，随着系统版本更新，这些插件不能很好工作了，但是脚本是不变的，原理也是不变的。

这次成功实现Jenkins持续集成，我试错了很多次，走了不少弯路，这里记下来共同进步。

jenkins_failed_history