基于lcov-1.11的：CodeCoverage4iOS



 


阅读目录

  • 环境准备
  • Xcode工程配置
  • 构建并安装程序
  • 收集代码覆盖率
  • 过滤结果
  • 合并多个Coverage.info⽂件⽣成覆盖率报告:
  • 参考文献



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打包

  1. 在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}/下
  1. 在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()


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⽂件⽣成覆盖率报告:

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