iOS自动化探索（十）代码覆盖率统计

iOS APP代码覆盖率统计

 

今年Q3季度领导给加了个任务要做前后端代码覆盖率统计， 鉴于对iOS代码比较熟就选择先从iOS端入手，折腾一整天后终于初步把流程跑通了记录如下

 

覆盖率监测的原理

Xcode中配置编译选项后， 编译后会为每个可执行文件生成对应的 .gcno 文件；之后在代码中调用覆盖率分发函数，会生成对应的 .gcda 文件。

• gcno：包含基本的块信息，以及代码行与块的映射关系；
• gcda：包含代码行执行的情况，以及覆盖率的信息归纳；

执行完测试后，提取goda并借助工具与gcno做对比给出检测报告

 

必要知识储备或条件: 

• 项目源码
• Xcode开发环境，包括开发者账号
• Cocopods基础用法
• Xcode真机运行基础操作
• 抓取APP沙盒日志基础操作
• Git基础操作

以上说的几个都不懂也行， 让开发帮忙做这些然后编个代码覆盖率统计的包给你测试， 测完把手机给开发取数据生成报告。 注意每次测试完先按下HOME键把程序退到后台等几秒让app自己生成日志文件

下面开始讲步骤

 

步骤1： 拉取项目代码

git clone XXXXXXXXXXX

 

步骤2： 编辑Podfile文件， 添加XcodeCoverage库

打开终端， cd到项目路径编辑Podfile

vi Podfile

添加：

pod 'XcodeCoverage', ‘~>1.0'

运行pod update安装依赖库

pod update

 

 步骤3：Xcode工程配置

1. 使用Xcode打开项目，Targes -> 选择你的APP -> Build Settings -> 搜索Preprocessor Macros -> 展开在Debug一栏加入NT_COVERAGE=1

注意这里我们都只修改Debug模式下的属性， 避免影响线上版本的打包发布

2. 同样在Build Settings中将以下3项的Debug模式改为Yes

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

 

3. Build Phase中 -> New Run Script Phase -> Run Scrip中添加Pods/XcodeCoverage/exportenv.sh

 这里有个注意的地方， 如果原本项目中已经有一个run script也还是新建一个

#4. AppDelegate.m中applicationDidEnterBackground方法添加以下代码

#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

 

步骤4： 编译安装

选择Debug模式安装到手机或者模拟器上

 

步骤5：手动测试或者运行自动化测试

注意每次完成测试后先按Home键退到后台， 等几秒让APP产生覆盖率日志不要直接杀掉APP进程

 

步骤6：提取真机上的.gcda文件

如果是在模拟器上运行测试可以跳过此步

1. 打开Xcode -> window -> Devices and Simulaters， 选择运行测试的真机

2. 在Installed Apps中选择测试的应用，然后点击底部的齿轮按钮选择Download Container

3. 会得到一个xxxx.xcappdata文件

4. 右键点击xcappdata文件 -> 显示包内容， 进入AppData/Documents/arm64/, 拷贝里面的所有.gcda文件

5. 进入项目目录/Pods/XcodeCoverage, 打开env.sh, 找到 OBJECT_FILE_DIR_normal属性和CURRENT_ARCH属性的值， 这里要注意下如果CURRENT_ARCH的值是undefined就改成arm64（关键）

6. 打开Finder，使用shift+command+G按钮输入

<OBJECT_FILE_DIR_normal>/<CURRENT_ARCH>

，其中 

OBJECT_FILE_DIR_normal

 及 

CURRENT_ARCH

 是上一步找到的值，(尖括号注意去掉)

7. 把上面第4步拷贝的所有.gcda文件拷贝到第六步打开的目录中

 

步骤7：生成覆盖率报告

打开终端， cd进入项目目录/Pods/XcodeCoverage, 运行命令:

./getcov --show

即可自动生成覆盖率报告

 

整个过程手动操作较多， 可以继续研究下如果实现自动化

其中步骤6可以使用ifuse挂在沙盒来实现自动化提取.gcda文件， 方法可以参考下面这篇

使用libimobiledevice + ifuse提取iOS沙盒文件