iOS 9 学习系列: Xcode Code Coverage
Code coverage 是一个计算你的单元測试覆盖率的工具。
高水平的覆盖给你的单元測试带来信心。也表明你的应用被彻底的測试过了。
你可能写了几千个单元測试,但假设覆盖率不高。那么你写的这套測试可能价值也不大。
这里并没有一个确切的百分比,要求你必须到达这个覆盖率。这非常大程度上取决于你的项目(的详细情况)。
譬如说,假设你的项目中有非常多不能写单元測试的视觉组件,那么覆盖率就会比单纯处理数据的框架要低的多。
Code Coverage in Xcode
在过去,假设你想要制作一个測试的代码覆盖报告出来,须要设置非常多[选项]。
非常复杂,还有很多须要手动设置。
在 iOS 9中,苹果提供了智能的代码覆盖工具,他是和 LLVM 一体的。每次执行測试都会被调用和计算。
Using the Code Coverage Tools
如今我们用一个样例来展示,如何使用新的 code coverage 工具和如何提升如今的測试用例。完毕后的代码放在了 Github 上,你能够跟着做。
第一件事是创建一个新项目。并确认你选上了Unit tests选项。
这会按要求创建一个默认项目,现我们须要測试点什么。这个測试可能是你的随意需求,这里我加入一个空的 swift 文件,里面写好了一个全局的方法。
这种方法检測两个字母串是否是仅排序不同的同样字母组成的词。
写成全局的方法,可能不是好的设计,但这里我们仅演示一下。
这是一个相对简单的方法。所以我们可能会得到一个没有不论什么问题的。100%覆盖的測试覆盖率。
一旦你写好了算法,就该写个測试了。打开项目创建时已经创建好了的默认的XCTestCase,加入一个以下的简单的測试方法。他看起来是这样子的。
在执行測试之前,我们必须先确认 code coverage 是否被打开了,写代码时,默认是关闭的。所以你须要编辑一下你的測试 scheme,把它打开。
确保"Gather coverage data"是被选中的。然后点击关闭button,执行測试的 target. 我们希望刚刚创建的測试用例可以顺利通过。
The Coverage Tab
一旦这个測试通过了。你就能知道 checkWord 这种方法,至少有一条路径是对的。但你不知道的是。还多多少没有被測试到。
这就是code coverage这个工具的优点。当你打开code coverage tab后,你能够清楚的看到測试的覆盖情况。他们按找 target, file, function 进行了自己主动分组。
打开Xcode左边窗体的Report Navigator面板,选中你刚执行的測试。
然后在tab中选中 Coverage。
这会展示一个你的类、方法的列表,并标示出每一个的測试覆盖率。假设你将鼠标悬停在checkWord这种方法上,你可以看到測试的覆盖率是28%。
不能接受啊!我们须要找到。那些代码分支是可以被測试运行。那些是不能的,进而改善他们。双击方法的名字,Xcode会打开类的代码,而且看到code coverage的情况。
白色的区域表示这些代码时測试覆盖过的。
灰色区域时測试无法覆盖的,我们须要加入很多其它的測试用例来覆盖灰色部分的代码。
在右手边的数字,表明这些代码块,在这次測试中被运行的次数。
Improving Coverage
非常显然,28%的覆盖率不是我们的目标。
这里没有 UI,看起来是个完美的编写測试用例的候选function。所以,我们加入一个測试用例。
理想情况下,我们希望每一个分支都能被測试到。
这样就能达到完整的覆盖。加入以下的測试用例到你的測试类中。
这些測试用例应该可以全然覆盖我们的代码了。执行一下单元。然后打开最后一个測试报告。
我们成功了,100%的覆盖率。
你能够看到整个代码都变成了白色,右面的数字也展示了每一个代码段至少被运行了一次。
使用code coverage是一个很棒的方式,帮你建立真正有价值的測试组合。远好于你写了许多測试用例,但没有真正測试到代码。
Xcode 7 让这样的方式变的很easy,我推荐你在项目中开启 Code Coverage。即使你已经写好了測试。也能够帮你知道究竟測试写的怎么样。
Demo在Github地址: https://github.com/fish-yan/XCode-Code-Coverage