下载安装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 的新的证书,也就是类似于账户的东西:
也有一些公司的 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 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 自动上传的脚本,你可以搜索一下,很简单的。
手动构建成功后,表示基本功能已经完成,后续可以完善其他配置
-
配置fir/蒲公英自动上传。如果提示 fir 命令没找到,那么需要修改一下Jenkins的环境变量:
系统管理->系统设置->环境变量(environment path)
jenkins_environment_path -
配置构建后邮件通知 http://blog.csdn.net/fullbug/article/details/53024562
关于Jenkins
在这个持续集成的方案里,Jenkins的主要职责是随时监听代码仓库的变动,一旦代码仓库改动,满足打包要求,就触发自动构建。自动构建的具体实施是依靠 xcodebuild 脚本来实现的。之前有大神做了一下插件来封装了这些脚本,随着系统版本更新,这些插件不能很好工作了,但是脚本是不变的,原理也是不变的。
网友评论