iOS代码覆盖率测试工具

基于lcov-1.11的：CodeCoverage4iOS

阅读目录

iOS code coverage test tool.

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

环境准备

Mac OS X :10.8.5+ 建议10.9

Xcode :5.0+ 建议6.1

回到顶部

Xcode工程配置

拷贝CodeCoverage4iOS项目到主工程根目录，即${your_proj.xcworkspace}所在目录
在Xcode中设置全局变量 NT_COVERAGE=1，用于代码覆盖率开关控制，如配置路径 iOSProj —> TARGTS -> MyApp -> Build Settings -> Preprocessor Macros -> Debug中添加NT_COVERAGE=1
对主工程及依赖工程在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打包

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

- (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}/下

在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产生的残余内容。

回到顶部

收集代码覆盖率

APP安装成功后可以对进行相应的测试操作，完成操作后点击Home键，此时程序会生成.gcda文件到对应目录。
生成覆盖率报告:
- 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()

exclude_data()

{

LCOV --remove $COVERAGE_INFO_DIR/${LCOV_INFO} "Developer/SDKs/*" -d "${OBJ_DIR}" -o $COVERAGE_INFO_DIR/${LCOV_INFO}

LCOV --remove $COVERAGE_INFO_DIR/${LCOV_INFO} "main.m" -d "${OBJ_DIR}" -o $COVERAGE_INFO_DIR/${LCOV_INFO}

# Remove other patterns here...

}

回到顶部

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

将Coverage.info文件全部放置到CodeCoverage4iOS/coverage下,如 Coverage1.info、Coverage2.info、Coverage3.info
执行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