iOS代码覆盖率测试工具

iOS code coverage test tool.

基于lcov-1.11的iOS代码覆盖率测试工具，适用与iOS真机与模拟器。

环境准备

Mac OS X :10.8.5+ 建议10.9

Xcode :5.0+ 建议6.1

Xcode工程配置

1. 拷贝CodeCoverage4iOS项目到主工程根目录，即${your_proj.xcworkspace}所在目录

2. 在Xcode中设置全局变量 NT_COVERAGE=1，用于代码覆盖率开关控制，如配置路径 iOSProj —> TARGTS -> MyApp -> Build Settings -> Preprocessor Macros -> Debug中添加NT_COVERAGE=1

3. 对主工程及依赖工程在Build Settings做如下配置:

   • Generate Debug Symbols 配置成YES
   • Generate Test Coverage Files 配置成YES
   • Instrument Program Flow 配置成YES

   例如:iOSProj —> TARGTS -> MyApp -> Build Settings -> Generate Debug Symbols

   以上配置建议仅在Debug下配置为YES，避免影响Release打包

4. 在AppDelegate.m中添加如下代码:

   ?

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

   - (void)applicationDidEnterBackground:(UIApplication *)application {     ...     #if NT_COVERAGE         #if !TARGET_IPHONE_SIMULATOR             NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);             NSString *documentsDirectory = [paths objectAtIndex:0];             setenv("GCOV_PREFIX", [documentsDirectory cStringUsingEncoding:NSUTF8StringEncoding], 1);             setenv("GCOV_PREFIX_STRIP", "13", 1);         #endif           extern void __gcov_flush(void);         __gcov_flush();     #endif     ... }

   当程序被拉到后台时调用__gcov_flush()生成.gcda文件，此文件中记录了代码覆盖率，注意__gcov_flush()可重复调用，记录为追加写。

   • iOS Simulator : .gcda文件会生成到默认路径~/Library/Developer/Xcode/DerivedData/iOSProj-cndbgdtazzzhaebuyvgjsqmkvwdr/Build/Intermediates/MyApp.build/Debug-iphonesimulator/MyApp.build/Objects-normal/i386·下
   • iPhone : .gcda文件会生成到对应App沙盒Document/${CURRENT_ARCH}/下

5. 在Build Phases中添加执行脚本:

   在TARGTS -> MyApp -> Build Phases -> New Run Script Phase中编辑Run Script 添加 CodeCoverage4iOS/exportenv.sh

   注意 : 要求对主工程及依赖工程都需要做此配置，主要脚本执行路径为相对路径，比如依赖工程与主工程同级目录，那么需要将脚本路径修改为相对路径../CodeCoverage4iOS/exportenv.sh

构建并安装程序

完成以上配置可以对Xcode工程进行构建,在使用Xcode安装app前确保CodeCoverage4iOS目录下envs.sh文件已删除

注意 : 如果只执?BuildCommand+B也会产?envs.sh文件,建议Build成功后检查删除envs.sh?件,再执?Command+R,确保envs.sh没有上次build产生的残余内容。

收集代码覆盖率

1. APP安装成功后可以对进行相应的测试操作，完成操作后点击Home键，此时程序会生成.gcda文件到对应目录。

2. 生成覆盖率报告:

   • iOS Simulator : 如果测试设备为iOS模拟机可直接双击执行CodeCoverage4iOS/getcov
   • iPhone : 如果测试设备为iPhone真机，首先需要从沙盒Document/${CURRENT_ARCH}下拷贝.gcda文件到CodeCoverage4iOS/gcda下，再执行CodeCoverage4iOS/getcov

   执行CodeCoverage4iOS/getcov过程中会在目录CodeCoverage4iOS/coverage下生成coverage.info文件，根据coverage.info文件生成最终报告。PS:如果需要合并测试结果，需要保留此文件

   测试报告生成路径:CodeCoverage4iOS/report/index.html

过滤结果

如果需要对收集的覆盖率结果进行过滤，可以编辑CodeCoverage4iOS/getcov中的函数exclude_data()

合并多个Coverage.info?件?成覆盖率报告:

1. 将Coverage.info文件全部放置到CodeCoverage4iOS/coverage下,如 Coverage1.info、Coverage2.info、Coverage3.info
2. 执行CodeCoverage4iOS/mergecov 生成合并后的报告

参考文献

https://developer.apple.com/library/ios/qa/qa1514/_index.html

http://qualitycoding.org/xcode-code-coverage/

项目主页：http://www.open-open.com/lib/view/home/1417661077558