iOS单元测试-02-初识覆盖率

[TOC]

前言
上一篇讲了如何进行一个简单的测试。在实际的场景中，我们测试完成之后，更多的是需要根据单元测试的结果来分析我们项目中是否存在问题，作为一个安全保障网。这个时候我们需要一个表格，能显示出我们这次测试过程中，哪些方法被测试了，哪些没有被测试到，所以就会有一个覆盖率的概念，表示测试过程中被覆盖的代码所占全部代码的比例。

开启覆盖测试

Edit Scheme

image
勾选Gather coverage for
这里可以根据需求选择指定的target做覆盖测试

image

打上勾之后，直接close即可
查看覆盖率
测试完成之后，这里会出现一个Coverage的选项，
选中Coverage即可查看本次测试的覆盖率

image
- mian.m 覆盖率100%
  我们知道这个文件里面只有一个main方法，作为程序的入口，肯定是会被覆盖的，所以是100%
- AppDelegate.m文件，覆盖率33.3%
  这个文件里面只有两个方法在启动的时候会执行，所以覆盖率是33.3%
  
  image
- ViewController.m，覆盖率60%
  5个方法，执行了3个，所以覆盖率是60%
  
  image
查看覆盖率文件
我们可以在xcode中查看这个覆盖率，但是在其他地方仍然是看不到这个覆盖率的，不能再其他平台上看到。
- 在Finder中查看源文件
  
  image
- 进入熟悉的DerivedData文件夹
  
  image
- 打开该文件
  
  image
  
  系统提示没有工具可以打开该文件，这也就说明这个文件并不能被可视化
- 查看文件包内容
  
  image
  
  一大堆看不懂的文件。

XcodeCoverage工具

XcodeCoverage源码

XcodeCoverage工具使用

下载仓库源码
将仓库源码所在文件夹设置放到与项目根路径同级目录下

image
使用1：在项目中添加脚本

image

image
```
$SRCROOT/../XcodeCoverage/exportenv.sh
```
根据上面文件存放的目录结构，这里只要设置一个能指向脚本exportenv.sh的路径就行了

使用2：设置项目配置
- 将图中两个配置改为YES
  
  image
- 配置scheme
  
  image

使用3：关联XcodeCoverage.xcconfig文件
- 在XcodeCoverage文件夹中找到XcodeCoverage.xcconfig文件
- 将文件拖到项目中，会弹出一个选项框，反选所有Add to Targets中的选项。如果不反选，这个文件将会被引入到项目的资源文件中。
  
  image
做完上述配置之后，使用cmd+U，开始进行测试。
测试完成，查看结果
- 在xcode自带的GUI中查看就不做累述了
- 看看怎么使用XcodeCoverage工具来查看
  因为需要读缓存里面的数据，在真机上是读不到这个文件的，所以不支持连真机测试，其实单元测试讲究的就是小，如果需要连接手机跑整个项目，也失去了单元测试的意义了。
  1. 打开终端，进入XcodeCoverage文件夹
    
    image
  2. 输入命令
    bash getcov -s或者是./getcov -s
    
    image
  3. 显示报告
    命令会自动使用默认浏览器打开这个文件
    
    image

XcodeCoverage工具解读

官方地址推荐的是使用cocoapods集成，因为我们项目中没有直接使用cocoapods结构，所以需要解除pods依赖，从而设计成根据文件路径去读取。
在引用XcodeCoverage.xcconfig文件的时候，一定不能直接将这个文件添加到某个target中
查看结果命令: bash getcov
- -s or --show: 显示HTML文件
- -x or --xml: 生成XML格式的文件
- -o output_dir: 输出到指定文件夹.
- -i info_file: 指定名称或者是生成lcov的info文件
- -v: 启用版本输出
- -h or --help: 显示用法

脚本解读

exportenv.sh脚本

scripts="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
export | egrep '( BUILT_PRODUCTS_DIR)|(CURRENT_ARCH)|(OBJECT_FILE_DIR_normal)|(SRCROOT)|(OBJROOT)' > "${scripts}/env.sh"

从脚本的命令来看，可以知道这个脚本是生成一个env.sh文件，
${scripts}：输出的路径就是XcodeCoverage文件夹的路径

env.sh脚本
这个脚本是在编译的时候，运行项目中的脚本生成的，会一直变化的

export BUILT_PRODUCTS_DIR="/Users/guowenchao/Library/Developer/Xcode/DerivedData/MTUnitTestDemo-edvagmnwobpzkkbeestmpmruroch/Build/Products/Debug-iphonesimulator"
export CURRENT_ARCH="x86_64"
export OBJECT_FILE_DIR_normal="/Users/guowenchao/Library/Developer/Xcode/DerivedData/MTUnitTestDemo-edvagmnwobpzkkbeestmpmruroch/Build/Intermediates.noindex/MTUnitTestDemo02.build/Debug-iphonesimulator/MTUnitTestDemo02.build/Objects-normal"
export OBJROOT="/Users/guowenchao/Library/Developer/Xcode/DerivedData/MTUnitTestDemo-edvagmnwobpzkkbeestmpmruroch/Build/Intermediates.noindex"
export SRCROOT="/Volumes/wenchao/DesktopFile/File-Mastercom/Doc-培训/培训-20190712-单元测试/03-测试案例/MTUnitTestDemo/MTUnitTestDemo02"

从生成的env.sh文件可以看出，这里输出的都是我们的环境路径，这写路径是为了存放后面生成的报告而准备的路径

.gitignore文件
这个是git的忽略文件，而这个文件中只有以一个忽略文件env.sh，这也刚好说明了上面那个脚本不用我们处理。

清理环境命令：bash cleancov
忽略指定文件夹中的内容
在项目的${SRCROOT}文件夹下添加文件.xcodecoverageignore

image

文件内容格式：
```
${SRCROOT}/MTUnitTestDemo02/UnusedFiles/*
```
${SRCROOT}：表示当前工程的根文件路径，其他需要忽略的文件夹，可以在这个里面配置
*：表示文件夹UnusedFiles/里面的所有文件