使用Hubson的iOS工程的CI集成

单元测试

我使用的单元测试框架是GHUnit，相比自带的OCUnit，好处是可以实现异步测试，异步网络请求的测试很方便实现，而且自带图形界面，在界面上课以很方便看到每个用例的测试结果和时间。

Github上的地址是 https://github.com/gabriel/gh-unit

集成测试

集成测试使用的测试框架是Kif，使用此框架用objc编写测试用例，每个用例实现可以模仿用户点击屏幕操作，包括指定tableview的指定单元格、点击alertview、actionsheet，点屏幕某个坐标值、键盘输入等。

可是有些情况下并不能完全模拟用户的点击，例如第一次使用地理位置时候提示是否允许使用，这种情况下不能点击到alertview的按钮。还有如果是进入的是网页或者其他网络请求的话，一般有延迟，可以使用等待页面出现某个元素的等待时间，或者直接设置一定的等待时间。

Github上的地址是 https://github.com/square/KIF

Hubson服务器的配置

1.     配置编辑从节点

因为编译iOS工程一般需要在安装有在xcode的mac os的计算机上，Hubson服务器一般不具备，所以要配置该电脑作为Hubson的从节点。从hubson连接到节点可以使用SSH和客户端等方法，我使用了通过在mac os上安装一个JNLP客户端来连接到hubson,需要安装java环境。

或者在终端执行下面的命令

javaws http://10.18.103.251:8080/computer/iOS-social-SDK/slave-agent.jnlp

2.     获取源代码

我使用了git来进行代码管理，hubson配置只需要配置git项目的url和分支，每次集成就会自动去取该地址分支的源代码。

3.     使用hubson的Xcode插件，进行Xcode工程的编译

进行Xcode工程的编译可以使用hubson的xcode插件，插件可以在hubson的插件管理安装。安装之后插件就会显示该工程可选编译哪几个target，是否生成ipa等。

4.     使用脚本运行单元测试

我使用的GHUnit框架，如果要使用CI的话，按照官方文档除了单元测试的target之外还需要另外一个执行该target的一个运行GHUnit框架提供的脚本target，然后在hubson服务器上用脚本执行该脚本target。GHUnit还有生成测试结果xml文件的功能，最后把结果放到指定的文件夹里。

下面的target Tests就是所说的脚本target。

WRITE_JUNIT_XML=YES JUNIT_XML_DIR=test-results GHUNIT_CLI=1 EXECUTABLE_PATH="GHTest.app/GHTest"  xcodebuild -target Tests -configuration Debug -sdk iphonesimulator build

在iOS 6.0 SDK使用此方法有问题 

Publish JUnit test result report

SocialSDK/build/test-results/*.xml

5.     使用脚本运行kif测试

类似单元测试，我们需要用第三方脚本运行测试。可是集成测试是模仿用户的操作，需要运行模拟器，所以需要第三方框架来运行模拟器。Kif官方推荐使用的是WaxSim，可是我实际使用发现，WaxSim很久没更新，和现在Xcode不太兼容而存在很多问题，后来使用了由phonegap推动的ios-sim。（https://github.com/phonegap/ios-sim）。安装过程很简单，只需要运行brew install ios-sim。在测试机上尝试可用后，再在hubson上运行ios-sim脚本发现有问题，原来还要引入环境变量export PATH=$PATH:~/bin:

hubson的完整的脚本是

export PATH=$PATH:~/bin:

ios-sim launch /Users/ios_umeng/Library/Developer/Xcode/DerivedData/SocialSDK-guawiwrvtzvqhpgtpgetszzszuzo/Build/Products/Debug-iphonesimulator/IntegrationTest-Kif.app

在kif文档介绍使用CI最后只是用grep命令找到测试结果的文本，没有像GHUnit那样可以生成测试结果，所以我们只能自己用脚本从log生成测试结果的xml文件。下面是把结果输出到指定的文件：

ios-sim launch  /Users/yeahugo/Library/Developer/Xcode/DerivedData/SocialSDK-bhpemjpovpvbspgtujucmsfxtdde/Build/Products/Debug-iphonesimulator/IntegrationTest-Kif.app --stderr /Users/yeahugo/Documents/tmp/KIF$$.txt

然后再用脚本在这个文件中查找相应的结果，生成xml格式的文件，像GHUnit那样，在hubson就会看到测试结果报告。

6.     自定义配置

由于使用集成测试我们需要更改一些代码，例如我们需要测试部署在测试服务器上的代码，我在我的xcode工程把服务器地址写在文件上，在hubson上通过修改该配置文件的url来指定测试服务器地址。

sed -ig 's/log.umsns.com/test.umsns.com/' SocialSDK/SocialSDK-config.plist

除此之外还进行其他配置。

7．Hubson其他配置

可以配置hubson把结果发送到邮箱，按照每天时间周期来触发等等。