使用Jenkins搭建iOS开发的CI服务器

本文为webfrogs原创,转载请注明作者及出处!

目录


    简介
    下载并运行
    Jenkins配置
        安装git插件
        E-mail设置
    自动化构建
        远程仓库设置
        触发条件设置
        编译设置
        编译后行为设置
    单元测试
    最后

## 简介 —-

持续集成CI(continuous integration)是一种可以增加项目可见性,降低项目失败风险的开发实践。iOS开发中CI的选择有很多,比如可以使用Apple提供的Bots来完成自动化构建和单元测试,其优点就是和Xcode深度集成,只需几步配置就可以完成,缺点就是不够灵活,可定制化程度不高。这篇文章主要讲解如何使用开源社区的一个CI工具Jenkins来搭建iOS开发的CI环境。如果是搭建单独CI服务器的话,就需要一台单独的mac机器了。

## 下载并运行 — 打开Jenkins的官网,在页面的右侧,点击下载最新版本的Jenkins的war包。

下载完成后,打开terminal,进入到war包所在目录,执行命令:

java -jar jenkins.war --httpPort=8888

httpPort指定的就是Jenkins所使用的http端口,这里指定8888,可根据具体情况修改。待Jenkins启动后,打开浏览器输入地址:

http://localhost:8888/

便可以打开Jenkins的管理界面了。

## Jenkins配置 — #### 安装git插件

Jenkins默认没有安装git插件,需要手动选择安装。进入Jenkins的管理界面,依次选择Manage Jenkins->Manage Plugins,选中“Available”选项,在页面的右上角的“Filter”中输入git过滤条件,在所有列出的结果中,选中“Git Client Plugin”和“Git Server Plugin”这两个选项,然后点击按钮“Download now and install after restart”。等待插件下载安装成功后,重启Jenkins。如下图所示:

图片

#### E-mail设置 Jenkins可以在适当的时机发送邮件通知,比如自动化构建失败时。这就需要对E-mail的发送进行相关的设置。

发送邮件使用的是SMTP协议,首先要设置Jenkins的管理员邮箱,在Manage Jenkins->Configure System的“Jenkins Location”中设置“System Admin e-mail address”为需要的邮箱,也就是Jenkins发送邮件的发件人。

接下来设置邮件SMTP的相关信息,在“E-mail Notification”区域中,点击“Advanced…”按钮,然后进行设置,首先填写SMTP服务器地址,选中“Use SMTP Authentication”的复选框,然后输入用户名和密码,最后在“Test configuration by sending test e-mail”中输入一个测试邮箱来测试邮件是否能发送成功。如果成功,会有相关提示,如下图所示。

图片

注意: 在设置邮箱时,Jenkins管理员邮箱要与SMTP中设置的发送邮箱为同一个邮箱,否则在使用比如qq邮箱或者是163邮箱时,就会报错。

### 自动化构建 —- 在Jenkins中,所有的任务都是以“Job”为单位的。下面以新建一个iOS项目Daily Build的自动化构建Job为例来做一个演示。

在Jenkins管理的首页左侧,点击“New Job”,接下来输入Job的名字,这里输入“Dailybuild”,选择“Build a free-style software project”然后点击“OK”,进入下一个页面。

#### 远程仓库设置

首先进行版本控制的相关设置,这里我们选择git。输入git的仓库地址,然后选择需要build的分支,另外,在“Additional Behaviours”中,还可以选择一些额外的git操作。如下图。

图片

提示: Jenkins使用当前用户.ssh目录下的公私钥来进行git的相关操作。

#### 触发条件设置

下一步,设置build的触发条件,由于是做Daily Build,所以在“Build Triggers”中,选择“Build periodically”,然后在输入框中输入build的规则,这里,我们的规则是每个工作日的下午6点25到30分之间进行build,所以在输入框中输入“H(25-30) 18 * * 1-5”(点击输入框右边的问号,会有详细的规则编写说明),如下图。 图片

#### 编译设置

然后,进行对工程编译的相关设置。这里,可以使用Jenkins自带的xcode插件(需要安装,参考上面git插件的安装方法)来完成,也可以自己编写脚本来完成。编写脚本时,可以直接使用Xcode的xcodebuild来写,也可以使用Facebook提供的xctool来做。但在本例中使用的是本人遍写的makefile来完成编译打包。这个makefile的功能有:指定Provisioning Profile打包编译,生成itms-services协议相关文件并以scp或者ftp方式上传到服务器来实现ota功能,发送邮件通知和iMessage通知。使用的makefile的github地址在这里,里面有使用说明。

点击“Add build step”按钮,选择“Execute shell”,在command中输入一下内容:

#!/bin/zsh
make clean
make
make upload
make sendEmail
make sendIMsg

如图所示: 图片

说明: 如果不使用iMessage通知,可以去掉第一行和最后一行,否则,Jenkins默认的shell会导致iMessage通知不能正常发送。

#### 编译后行为设置 工程成功编译以后,我们可以设置编译出来的ipa文件(甚至可以直接是ota文件),将其与本次build的相关结果放到一起,提供下载。也可以在build失败时,发送邮件提醒。设置如下。

点击“Add post-build action”选择“Archive the artifacts”,在输入框中输入“build/*.ipa”,就可以将编译打包后的ipa文件集成。点击“Add post-build action”选择“E-mail Notification”,在输入框中输入编译失败后邮件的通知者邮箱,如有多个,以空白字符分隔,如下图: 图片

至此,一个Daily Build的Job基本设置完成,点击“Save”按钮保存设置。在Job中,点击“Build Now”,测试下我们刚才的配置。如果build失败,可以点击“Console Output”查看log来查找错误的地方。如果成功,在相应的build中,可以看到如下图的内容: 图片

### 单元测试 —- 在本例中,iOS工程的单元测试选择xcode自带的XCTest框架(Xcode5之前叫做OCUnit)。创建单元测试Job和自动化构建的Job过程一样,只在触发构建规则,build的脚本和编译后的规则有些不同。以下只说明不同的地方。

单元测试的触发规则应该在git仓库的每次有新提交时就触发执行,所以在”Build Triggers”中,选择“Poll SCM”,在规则中写入“H/10 * * * *”,意思是每十分钟轮询一次远程仓库,如果有新的提交,则开始构建。可以根据自己需求来设置轮询的时间间隔。

接下来是在build中输入单元测试脚本。这里需要有一些准备,首先,由于Jenkins只接收Junit的单元测试报告,这里要安装一个将脚本执行结果的ocunit格式的测试报告转化为JUnit报告格式的脚本,该项目名叫OCUnit2JUnit,项目地址点这里。安装非常简单,命令行下执行gem install ocunit2junit(可能需要sudo权限)。第二步,需要在当前项目工程中,将项目schemes共享,并上传到远程仓库。在工程中选择“Manage Schemes”在弹出的菜单中勾选“Shared”,然后在git中将相应的shared shceme添加到版本控制中并上传到远程仓库。如下图

图片

“Build”配置中,依然选择“Execute shell”,shell的内容如下:

xcodebuild test -scheme testCI -sdk iphonesimulator7.0 -destination OS=7.0,name="iPhone Retina (4-inch)" -configuration Debug  2>&1 | ocunit2junit

这里的单元测试是在模拟器中进行,如果测试服务器连接着iOS设备,也可以设置在iOS设备中进行,只需修改上述shell的参数即可。

最后是编译后行为的设置,这里要将测试报告加入。点击“Add post-build action”选择“Publish JUnit test result report”,输入内容test-reports/*.xml保存设置。

接下来在单元测试的Job中,点击“Build Now”来测试一下Job的配置,如果配置正确,则会看到模拟器启动,然后运行了一下程序,之后在build的结果里,可以看到相应的测试报告,点击进去会有详细的信息,如下图:

图片

## 最后 —- 芈峮在《豆瓣ios自动化测试实践和经验》(视频地址PPT地址)中提到Jenkins还可以集成UIAutomation来进行iOS的UI方面的自动化测试,并且还发布了他们自己封装的UI测试工具ynm3k,项目地址点这里。待研究之后再写下相关的经验吧。



Previous     Next
nswebfrog /
Published under (CC) BY-NC-SA in categories iOS  tagged with iOS  CI