使用Jenkins搭建iOS开发的CI服务器
目录
简介
下载并运行
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
,项目地址点这里。待研究之后再写下相关的经验吧。
使用Jenkins搭建iOS开发的CI服务器的更多相关文章
- 使用 Jenkins 搭建 iOS/Android 持续集成打包平台【转】
背景描述 根据项目需求,现要在团队内部搭建一个统一的打包平台,实现对iOS和Android项目的打包.而且为了方便团队内部的测试包分发,希望在打包完成后能生成一个二维码,体验用户(产品.运营.测试等人 ...
- 搭建iOS开发环境
搭建ios开发环境 1. 直接购买Apple公司的电脑,如MacBook笔记本电脑,默认自带了Mac OS X操作系统. 2.下载安装Xcode和SDK 登录https://develope ...
- Windows下搭建IOS开发环境(一)
原文:http://blog.csdn.net/shangyuan21/article/details/18153605 我们都知道开发iPhone等ios平台的移动应用时需要使用Mac本,但是Mac ...
- Windows下搭建PHP开发环境-WEB服务器
PHP集成开发环境有很多,如XAMPP.AppServ......只要一键安装就把PHP环境给搭建好了.但这种安装方式不够灵活,软件的自由组合不方便,同时也不利于学习.所以我还是喜欢手工搭建PHP开发 ...
- Xcode5 + phoneGap2.9搭建ios开发环境-配置-测试-归档上传/phoneG...
前言: 小弟是做JAVA/Android的第一次搞这个ios,公司有mobile项目是使用phoneGap开发的,需要开发ios版本.什么都不会只能一点一点琢磨了……大神越过…… 原文链接:http: ...
- 简单搭建iOS开发项目框架
今天我们来谈谈如何搭建框架,框架需要做一些什么. 第一步:找到我们的目标我们的目标是让其他开发人员拿到手后即可写页面,不再需要考虑其他的问题. 第二步:我们需要做哪些东西各位跟着我一步一步来进行. 假 ...
- win7搭建ios开发环境
安装过程参考文章: http://jingyan.baidu.com/article/ff411625b9011212e48237b4.html http://www.loukit.com/threa ...
- IOS开发-phonegap及免证书及真机调试
回头补记(Last edited at 2015.5.24). 第一步:建立项目 参见:Xcode5 + phoneGap2.9搭建ios开发环境 下载phonegap2.9.1,解压. 命令行,进入 ...
- iOS开发网络篇—搭建本地服务器
iOS开发网络篇—搭建本地服务器 一.简单说明 说明:提前下载好相关软件,且安装目录最好安装在全英文路径下.如果路径有中文名,那么可能会出现一些莫名其妙的问题. 提示:提前准备好的软件 apache- ...
随机推荐
- lowercase calligraphic letters
本系列文章由 @yhl_leo 出品,转载请注明出处. 文章链接: http://blog.csdn.net/yhl_leo/article/details/53454402 LaTeX公式表达中,经 ...
- Oracle 数据库导出时 EXP-00008;ORA-00904
问题是客户端和服务器端版本问题,我本地是11g,而服务器端是10g. 规则1:低版本的exp/imp可以连接到高版本(或同版本)的数据库服务器,但高版本的exp/imp不能连接到低版本的数据库服务器. ...
- 201621123034 《Java程序设计》第12周学习总结
作业12-流与文件 1. 本周学习总结 1.1 以你喜欢的方式(思维导图或其他)归纳总结多流与文件相关内容. 2. 面向系统综合设计-图书馆管理系统或购物车 使用流与文件改造你的图书馆管理系统或购物车 ...
- 细说php2[正则表达式学习笔记]
<细说php>这本书应该是每个php程序员入门的必读书籍,里面讲的很多知识都很系统和详细,看了正则这部分,并练习了里面的案例,发现自己已经会了很多.... header('Content- ...
- [洛谷P3978][TJOI2015]概率论
题目大意:对于一棵随机生成的$n$个结点的有根二叉树,所有不同构的形态等概率出现(这里同构当且仅当两棵二叉树根相同,并且相同节点的左儿子和右儿子都相同),求叶子节点个数的期望是多少? 题解:令$f_n ...
- BZOJ - 2728 与非
题意: 给定N个数,一个数k和一个范围[L,R].每个数可以使用任意次,k表示与非不超过k位.求出范围内有多少个数可以由他们的与非和表示. 题解: m个数进行NAND,最终的数二进制下某一位如果为1, ...
- Linux下从零开始部署和使用Jaeger
最近在折腾Jaeger,Jaeger官网都是介绍如何通过Docker部署,二进制部署文档基本没有(已咨询过作者,作者说没文档!你参考Docker自己部署好了!!!),所以打算写一篇Linux部署. J ...
- 用HTML5绘制的一个星空特效图
<!doctype html> <html lang="en"> <head> <meta charset="UTF-8&quo ...
- Java Web 路径问题
可能在做文件上传或者 图片加载,资源加载 时候用到文件相对服务器地址 System.out.println(request.getRemoteUser()); //客户端用户System.out.pr ...
- 51nod 1273 旅行计划——思维题
某个国家有N个城市,编号0 至 N-1,他们之间用N - 1条道路连接,道路是双向行驶的,沿着道路你可以到达任何一个城市.你有一个旅行计划,这个计划是从编号K的城市出发,每天到达一个你没有去过的城市, ...