使用Jenkins+Calabash+Cocoapods搭建iOS持续集成环境

持续集成 持续集成究竟是什么呢？根据敏捷大师Martin Fowler的定义: 持续集成是一种软件开发实践。在持续集成中，团队成员频繁集成他们的工作成果，一般每人每天至少集成一次，也可以多次。每次集成会经过自动构建（包括自动测试）的检验，以尽快发现集成错误。许多团队发现这种方法可以显著减少集成引起的问题，并可以加快团队合作软件开发的速度。 只要是开发就有分工，哪怕是自己一个写也要分成多个模块。随着项目越来越大，模块也越来越多，各个模块是否可以征程协作就成了问题，有了持续集成，可以有如下好处： 持续集成中的任何一个环节都是自动完成的，无需太多的人工干预，有利于减少重复过程以节省时间、费用和工作量； 持续集成保障了每个时间点上团队成员提交的代码是能成功集成的。换言之，任何时间点都能第一时间发现软件的集成问题，使任意时间发布可部署的软件成为了可能； 持续集成还能利于软件本身的发展趋势，这点在需求不明确或是频繁性变更的情景中尤其重要，持续集成的质量能帮助团队进行有效决策，同时建立团队对开发产品的信心。 下面就给大家介绍，如何使用Jenkins+Calabash搭建持续集成开发环境。 环境 XCode 5.0 Mac OS X 10.9.2 Cocoapods CocoaPods简介 CocoaPods是一个负责管理iOS项目中第三方开源代码的工具。CocoaPods项目的源码在Github上管理。该项目开始于2011年8月12日，经过一年多的发展，现在已经超过1000次提交，并且持续保持活跃更新。开发iOS项目不可避免地要使用第三方开源库，CocoaPods的出现使得我们可以节省设置和更新第三方开源库的时间。 安装Cocoapods 1、安装Homebrew Homebrew是Mac下著名的包管理工具，RVM和以后用到xctool都需要用这个来安装，相当于Ubuntu的Apt-get。 安装方法是在命令行中键入 ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)" 之后执行环境检查 brew doctor 检查没有错误就可以使用了，如果出现错误，请参考提示进行修正。 确认无误后，可以安装第一个应用curl，一个用来下载的工具。使用命令 brew install curl 2、安装RVM 虽然Mac默认都带有Ruby，但是有些时候使用起来很麻烦(例如必须使用sudo来安装gem)并且只有一个版本，所以我们使用RVM来管理ruby的版本，ruby是自动化测试工具calabash的运行环境，所以必须要有。 安装方法是命令行中键入 \curl -sSL https://get.rvm.io | bash -s stable 过程中可能需要输入sudo密码。 使用淘宝源替换 sed -i .bak 's!cache.ruby-lang.org/pub/ruby!ruby.taobao.org/mirrors/ruby!' $rvm_path/config/db 3、安装Ruby 使用rvm下载ruby2.0版本 rvm install 2.0.0 选用2.0.0版本的ruby，并设置为默认 rvm use 2.0.0 --default 使用淘宝源替换gem源 rvm source --add http://ruby.taobao.org/ rvm source --remove https://rubygems.org/ 4、安装Cocoapods CocoaPods是一个用来帮助我们管理第三方依赖库的工具。它可以解决库与库之间的依赖关系，下载库的源代码，同时通过创建一个Xcode的workspace来将这些第三方库和我们的工程连接起来，供我们开发使用。 通过Gem安装Cocoapods gem install cocoapods 执行cocoapods的初始化 pod setup 该过程需要到github上拉取specs，速度很慢，可以喝杯咖啡慢慢等 使用Cocoapods 首先创建一个普通项目来演示下如何使用Cocoapods。 之后在命令行里面,进入到你的项目路径 cd /path/to/your/project pod init 之后会在项目根目录下创建好Podfile，修改下Podfile的内容 # #为Podfile的注释行，Podfile实际上是一个ruby代码段 platform :ios, "6.0" # platform后面跟平台和版本号，这里是ios6平台 # pod 'MKNetworkKit' 像这样写就可以引入第三方库了，为了简化，这里没有引入任何库 在目录执行pod插件install命令 pod install 每次使用pod install，它都会到github上更新spec库，耗费了不少时间，可以使用下面的命令跳过这个过程 pod install --no-repo-update 执行之后，会提示没有引入任何的第三方库，不要担心(因为我们真的没有引入)。你会发现目录上多了integration_test.xcworkspace这个工作区文件，以后我们就都使用这个打开项目了。 打开后如图所示   恭喜您，已经可以正常使用Cocoapods了。下一步就是使用Calabash进行自动化测试了。 Calabash Calabash是一款开源的跨平台UI测试工具，目前支持iOS和Android。它使用Cucumber作为测试核心，Cucumber是一个在敏捷团队十分流行的自动化的功能测试工具，它使用接近于自然语言的特性文档进行用例的书写和测试，支持多语言和多平台。 安装Calabash gem install calabash-cucumber 安装Calabash中文支持包 gem install calabash-cucumber-ios-cn 新建集成测试的Target 重新打开工作区，然后选择integration_test这个工程，打开配置，targets中integration_test上右键进行复制。 如果出现Duplicate iPhone Target对话框，选择Duplicate Only就可以，另外一个选项是复制并转换成iPad程序。 之后修改目标的名称 修改项目配置 修改scheme 共享scheme，目的是在版本管理中，让其他用户也可以获取到这些scheme 这样新的测试目标就创建好了，为什么要创建新的目标呢？ 不希望在发布的产品中包含测试代码 calabash默认启动-cal结尾的目标 引入Calabash包 修改Podfile文件，加入新的pod target 'integration_test-cal', exclusive: false do pod 'Calabash' end 到命令行里，进入到自己的目录，执行 pod install --no-repo-update 执行成功后，创建用例模板 calabash-ios gen 屏幕会出现 I'm about to create a subdirectory called features. features will contain all your calabash tests. Please hit return to confirm that's what you want. 按回车确认，就生成了features文件夹，我们的用例和测试配置都在这里了。你可以把features这个文件夹拖到项目中，方便使用xcode直接编辑，**注意不要选择任何目标**，以为这些文件根本没有必要编译和存到app中。 编写用例 Cucumber是使用gherkin来进行用例描述的，这是一种近乎自然语言的脚本，并且对多语言有很好的支持。具体的语法可以查阅它的官方wiki。 这里我们先写一个简单用例，修改features/my_first.feature # language: zh-CN 功能: 运行基准测试 做为一个iOS开发者 我希望有一个简单的基准测试 使我可以快速的开启测试 场景: 基准测试 假如 应用正在运行 那么 我把应用切到后台3秒 是的，就是这样的用例！你可以书写自然语言来描述一个功能，calabash就使用cucumber帮您测试了，神奇吧。 接下来还需要修改features/step_definitions/calabash_steps.rb，在这里包含中文解析，在最下面加上 require 'calabash-cucumber-ios-cn/calabash_steps.rb' 这个包里面带有中文的功能说明，具体可以看文档。 执行用例 激动人心的时刻终于到了，首先编译integration_test-cal这个scheme，然后使用模拟器运行一下，在模拟器打开Accessibility Inspector。模拟器->设置(Settings)->通用(General)->辅助功能(Accessibity)->Accessibility Inspector开启。 打开命令行，进到目录中执行命令 cucumber 可能需要输入密码，之后就看到模拟器重新加载，并按照我们的用例开始自动执行了。 执行结束后，会有下图的结果。 恭喜我们的2个步骤都成功了。快点用更多的功能和用例来测试吧_。 到这里，每个开发人员都可以通过cucumber命令来对自己写的内容进行测试了，这和我们的持续集成还有一段距离，那么接下来，我们介绍Jenkins这个持续集成web工具，实现真正的持续集成。 Jenkins Jenkins 是一个开源项目，提供了一种易于使用的持续集成系统，使开发者从繁杂的集成中解脱出来，专注于更为重要的业务逻辑实现上。同时 Jenkins 能实施监控集成中存在的错误，提供详细的日志文件和提醒功能，还能用图表的形式形象地展示项目构建的趋势和稳定性。 XCTool 使用Jenkins进行持续集成之前，还有一个前提，就是编译这个过程需要自动化，中途用xcode手动点的不行，所以我们需要有命令可以一次编译我们的工程，这里我们使用xctool这个工具，是facebook写的一个集成工具，用来编译和打包程序的。 安装方法是使用homebrew，在命令行执行 brew install xctool 安装好在程序目录下测试一下是否可以编译 xctool -workspace integration_test.xcworkspace -scheme integration_test-cal -sdk iphonesimulator7.1 clean build 注意这里的sdk每个人可能不同，要根据本机安装的sdk来写 ， 查看的方法是执行命令 xcodebuild -showsdks 如果显示** BUILD SUCCEEDED **那么可以进入下一步了。 Jenkins 安装jenkins还是使用brew brew install jenkins 安装好之后，可以通过使用命令行启动 java -jar /usr/local/opt/jenkins/libexec/jenkins.war 如果想自动启动，需要先执行以下命令，创建启动项 ln -sfv /usr/local/opt/jenkins/*.plist ~/Library/LaunchAgents 可以编辑一下~/Library/LaunchAgents/homebrew.mxcl.jenkins.plist这个文件 open ~/Library/LaunchAgents/homebrew.mxcl.jenkins.plist 想要让局域网都可以访问，需要把--httpListenAddress=127.0.0.1改成自己的局域网IP 手动启动启动项可以执行 launchctl load ~/Library/LaunchAgents/homebrew.mxcl.jenkins.plist 之后用浏览器就可以访问http://localhost:8080/来登录jenkins了 Jenkins启动之后，可以配置用户权限，但是我们为了简单，先不配置用户。 Jenkins Plugin Jenkins有一个很方便的功能，就是可以通过插件形式进行扩展，为了支持我们的持续集成，我们需要先安装必要的插件。 进入Jenkins网页的系统管理->插件管理->高级，找到右下角的“立即获取”就可以获得所有的插件信息了。 更新好之后，在可选插件里面，安装如下插件 Git Server Plugin #Git的支持，如果用svn就不需要了 Git Client Plugin #Git的支持，如果用svn就补需要了 Rvm #加载RVM环境变量以实用ruby的cucumber命令 Cucumber Test Result Plugin #解析Cucumber的测试报告 记得安装时勾选更新完自动重启 至此，我们持续集成的所有环境应该都满足了。 托管你的项目 Jenkins一定要从一个地方获得一份软件副本的，所以，要想使用持续集成，必须要有一个版本管理工具，在Jenkins中成为scm，我们的例子使用git，并且我已经将测试工程上传到CODE服务器上，地址在这里:https://code.csdn.net/zangcw/integration_test 创建一个项目 当你的源代码已经在代码托管服务器上之后，现在就可以在jenkins创建一个项目了。 我们创建一个自由风格的软件项目 并且对其配置 主要配置如下内容： 1.源码管理，示例中配置为https://code.csdn.net/zangcw/integration_test.git 2.构建环境，要勾选RVM，否则没有办法在脚本中执行cucumber这个命令 3.构建脚本，选择Execute shell，内容如下，请根据需要自行修改 cd $WORKSPACE /usr/local/bin/xctool -workspace integration_test.xcworkspace -scheme integration_test-cal -sdk iphonesimulator7.1 clean build mkdir -p test-reports cucumber --format json -o test-reports/cucumber.json 4.构建后的操作，选择Publish Cucumber test result report，指定报告的目录test-reports/cucumber.json 之后点击应用，即完成了配置 立即构建 还在等什么？马上点击立即构建吧。。。 等待构建的过程中，我们可以查看控制台输出 模拟器也会在中途弹出，然后自动关闭 构建结束后，我们可以看到构建结果 结果展示了变更、由谁触发的构建和测试报告，更多的信息大家可以自行挖掘。总之构建是完成了。 想要进行持续构建，需要设置成每个一段时间自动构建，在Build periodically中配置即可。 下一步该做什么？ 在淌通了这一整套流程之后，其实还是有很多事情等着我们来做的，下面是几个例子： 1.为Jenkins创建用户管理 2.修改脚本，自动存放ipa并上传到特定服务器 3.配置构建策略，每日1次，或者多次，或者监听git变化，有上传就构建 4.配置邮件策略，使大家及时获得反馈 总之，拥抱集成测试吧。