iOS持续集成:Jenkins篇

前言

大神们提出的一套开发规范建议:持续集成+测试驱动开发(CI+TDD)。其中,持续集成即Continuous Integration,简称CI。Jenkinsfastlane是目前比较流行的两种快速集成工具,这里介绍使用 Jenkins 完成iOS APP的持续集成。

Jekins安装

Jenkins 是一个用Java编写的开源的持续集成工具,提供了软件开发的持续集成服务,可以监控并触发持续重复的工作,具有支持多平台、插件拓展、开源等。

Jenkins依赖于Java环境,首先需安装和配置Java环境。(PS:是JDK,而非JRE)。

Jenkins的安装有多种方式,这里介绍两种:(PS:因为安装Jenkins的时候需要注意权限问题)

使用brew安装(推荐):

$ brew install jenkins

如果出错,bash:brew: command not found,这是由于当前环境没有安装homebrew。

安装homebrew ,代码执行:

$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

安装成功后,请重新安装Jenkins:brew install jenkins

或者使用安装包安装:

前往Jenkins官网,下载安装包,选择 Mac OS X :

Jenkins

安装下载的安装包,注意在 安装类型这步,选择自定义,取消选择 Start at boot as "jenkins" 这项,因为可能在后面由于权限的原因导致Jenkins打包失败:

安装成功后,浏览器会自动打开Jenkins网页服务,如果没有打开,请在浏览器输入 http://localhost:8080/
如果不能打开 http://localhost:8080/ ,可能是Jenkins服务未开启:

Jekins启用,输入:

$ sudo launchctl load /Library/LaunchDaemons/org.jenkins-ci.plist

Jekins停用,输入:

$ sudo launchctl unload /Library/LaunchDaemons/org.jenkins-ci.plist

如果报错:/Library/LaunchDaemons/org.jenkins-ci.plist: No such file or directory,
可以在命令行中输入:

$ jenkins

此时Jenkins会在命令行里打印相关的运行日志,再在浏览器里输入: http://localhost:8080/
这种情况的话,如果关闭执行 $ jenkins 命令的命令行,Jenkins也会停止服务。

Jenkins配置

安装成功后,浏览器会打开Jenkins的服务网页:

根据提示,前往查看initialAdminPassword:

$ sudo cat /Users/Shared/Jenkins/Home/secrets/initialAdminPassword

如果没有找到这个文件,可以在Jenkins日志里查找 initialAdminPassword字段 ,就可以看到密码啦。不知道Jenkins的日志在哪,可以点击页面的(not sure where to find it?)

然后下一步,选择安装建议的插件:

插件安装完毕后,创建用户,然后进入了Jenkins的管理界面了。在创建新项目之前,我们需要安装几个插件,Git plugin 和 Xcode integration 和 Keychains and Provisioning Profiles Management。系统管理 -> 管理插件 -> 可选插件,搜索并安装。

安装好后,我们可以先到 系统管理 -> Keychains and Provisioning Profiles Management :

这里需要选择 login.keychain ,在 /Users/{username}/Library/keychains/login.keychain 目录里。如果不能通过选择的话,可以把login.keychain拷贝到桌面,然后在选择上传。

Code Signing Identity,可以添加多项。进入钥匙串,选择开发者证书或发布证书,拷贝完全,粘贴至Jenkins的Code Signing Identity项里:

Provisioning Profiles Directory Path 填写成,注意替换为自己的username:

/User/{USERNAME}/Library/MobileDevice/Provisioning Profiles

然后保存。

创建项目

终于可以开始创建项目了,点击新建项目:

输入项目名称,选择 构建一个自由风格的软件项目,然后确定,进入配置页面。选择源码管理:

我们是Git的方式管理的,所以选择git。

Repository URL 可以使用 HTTP 或 SSH 两种形式的,这里需要注意,如果是采用 HTTP 形式的话,后面配置 Credentials 需要选择 Username with password 项,输入登录用户名和密码:

如果是采用 SSH 形式的话(不要ssh://前缀),后面配置 Credentials 需要选择 SSH Username with private key 项,输入用户名(随便输入)和与Git上公钥对应的私钥:

/Users/{username}/.ssh/id_rsa

如果红色报错的话,请核对Git地址和私钥或用户密码对应。

Branch Specifier (blank for 'any'):默认是master,你可以根据实际情况进行编辑。

构建触发器:可以选择某种情况下触发项目构建,也可以不选。

构建

点击增加构建步骤:

这里需要注意,如果你的项目是使用了cocoapods管理第三方库的话,这里需要增加一个脚本执行的步骤:Execute shell -> Xcode(即下一步骤) ,顺序不能错。这是因为,新版本的Xcode不能直接构建.xcworksapce项目,需要使用脚本。(PS:如果不是cocoapods管理的可以直接跳过这步)

脚本内容:

pod install
open Dispatcher.xcworkspace

配置Xcode

增加构建步骤选择Xcode:

依次填写:
Target:一般为工程名,cocoapods管理的项目不需要填写
Clean before build:构建前clean一下总是好的
Configuration:一般为Release
输出ipa名称:可以自定义,不填写则是采用默认的格式
ipa存放目录:$workspace/build/ 或者 其它。

Advanced Xcode build options

Xcode Schema File:如果你使用workspace,而不是project此项必填。与target类似,填写你需要构建的schema;
Xcode Workspace File:.xcworkspace文件的路径,$WORKSPACE表示的是当前项目的路径,"/"后面就是.xcworkspace后缀的文件名,注意:这里不需要填写后缀;
Build output directory:系统默认的Build目录是CONFIGURATION_BUILD_DIR,上面设置的ipa包的输出目录,其实就是相对于这个目录的路径;建议填写,比如填写 $WORKSPACE/build。

点击‘Save’,保存设置,开始构建吧。

选择某一次构建,点击命令输出(Console Output),查看构建的过程。祝你好运~

上传至蒲公英

如果要上传至测试平台的话,可以去查看测试平台关于Jenkins的文档。这里给出蒲公英的Jenkins上传至平台文档:使用 Jenkins 实现持续集成(iOS)

推荐阅读更多精彩内容