Android代码覆盖率工具使用

前言
Android 开发统计代码覆盖率，在之前的老版本中，需要借助第三方工具，在现在的新版本中，只要使用JaCoCo插件，就可以完成简单覆盖率测试。
与 Espresso 框架结合，进行覆盖率测试
Android SDK 现在已经内置了对 Emma Test Coverage框架的支持，可以在官方文档中进行查阅。 具体由 JaCoCo 工具进行覆盖率相关内容。 1.1 配置： 在 build.gradle 中将 testCoverageEnabled
设置为 true

android {
   buildTypes {
      debug {
         testCoverageEnabled = true
      }
   }
}

注：部分资料中，可能写需要在 build.gradle 中增加如下配置 apply plugin: 'jacoco'
或者 apply plugin: 'jacoco-android'

但是在实际使用发现，这个配置项并不需要。
使用：
为了能生成代码覆盖率报告，我们需要将Android设备或者模拟器连接到计算机，因为 在生成报告前，会执行 connectedCheck
任务。 之后，我们可以执行如下的命令行

/gradlew clean assemble

此命令会清空所有的编译产生class，防止之前的测试对后续造成影响。

/gradlew createDebugCoverageReport

该任务会分析 /src/main/java/
路径下的代码和 /src/androidTest/java/
目录下测试用例。
在执行这个任务之后，我们可以在模块的如下路径中找到代码覆盖率报告 /build/outputs/reports/coverage/debug/

我们可以在浏览器中打开 index.html 文件，可以看见可视化的报告。 同时，在同一级目录下，我们也可以找到可以供持续集成覆盖率分析使用的 report.xml 文件。

这里写图片描述

除了上面提到的文件，Gradle也会在如下的路径创建 coverage.ec
文件。 /build/outputs/code-coverage/connected/
碎片化带来的问题
由于 Espresso 需要在真机或者虚拟机上运行，由于android碎片化严重，经常出现各种问题。现进行一个问题与解决方案的汇总。
小米的问题
问题现象：小米手机异常：com.android.ddmlib.InstallException: Failed to establish session
解决方案：在开发者选项中，关闭 MIUI 优化选项。 http://en.miui.com/thread-255506-1-1.html

与 Robolectric 框架结合，进行覆盖率测试
谷歌对 Robolectric
框架支持力度一般，所以发现 JaCoCo 工具在使用此框架时候，需要进行的配置较多。
配置
在 build.gradle 中将 testCoverageEnabled
设置为 true

android { 
          buildTypes {
                        debug { testCoverageEnabled = true }
                             }
              }

在 build.gradle 中增加如下配置

apply plugin: 'jacoco' 

此框架中需要此配置。 然后在 gradle 文件中插入如下的配置，对JaCoCo进行设置

jacoco {
    toolVersion = "0.7.1.201405082137"   //版本号可用最新
}

def coverageSourceDirs = [
        '../app/src/main/java'
]

task jacocoTestReport(type:JacocoReport, dependsOn: "testDebugUnitTest") {
    group = "Reporting"

    description = "Generate Jacoco coverage reports"

    classDirectories = fileTree(
            dir: '../app/build/intermediates/classes/debug',
            excludes: ['**/R.class',
                       '**/R$*.class',
                       '**/*$ViewInjector*.*',
                       '**/BuildConfig.*',
                       '**/Manifest*.*']          // 去掉不进行检查的文件
    )

    additionalSourceDirs = files(coverageSourceDirs)
    sourceDirectories = files(coverageSourceDirs)
    executionData = files('../app/build/jacoco/testDebugUnitTest.exec')

    reports {
        xml.enabled = true
        html.enabled = true
    }
}

task jacocoTestReport(type:JacocoReport, dependsOn: "testDebugUnitTest")
这行的配置，中间的dependsOn
一定要设置成 testDebugUnitTest 后续才可以正确执行覆盖率测试。
https://github.com/kvandermast/my-robolectric-app
在这个例子中，此配置成了 testDebug
，实际测试发现会报错 Task 'jacocoTestReport' not found in root project ''.

使用
先执行如下的命令行，清除之前的残留配置。

/gradlew clean testDebugUnitTest jacocoTestReport

之后再执行命令行

/gradlew jacocoTestReport

执行该命令行后，会执行所有的单元测试用例，然后在如下位置生成报告。 build/reports/jacoco/jacocoTestReport/html 也可以通过浏览器对覆盖率情况进行查看

这里写图片描述

同时使用两个框架进行覆盖率测试
以为两个配置并不相同，可能会相互影响，网上也有不少解决方案，但是始终都是要修改gradle文件。
如： http://www.jianshu.com/p/4b03123b4f81
后来经过尝试发现。按照上述1， 2步骤配置后，两个框架的测试用例覆盖率检测其实并不冲突。 也就是说在配置好后，如果需要使用Espresso进行集成测试统计覆盖率，则执行如下命令

/gradlew clean assemble
/gradlew createDebugCoverageReport

如果需要使用Robolectric执行单元测试统计覆盖率，则执行如下命令

/gradlew clean testDebugUnitTest jacocoTestReport
/gradlew jacocoTestReport

可以分别生成覆盖率报告
与 Jenkins CI 的结合
为了能在 Jenkins CI 上发布报告，可以使用代码覆盖率插件，但是并不能确认插件的稳定性。另一种解决方案是 HTML Publisher plugin，我们可以增加相应动作，在 Jenkins 的任务中，通过默认的HTML界面产生覆盖率报告，我认为这是一种非常方便的方式，易于创建，并且方便进行代码导航，能定位到没有覆盖的代码行，方法和分支。

参考文档
http://blog.wittchen.biz.pl/test-coverage-report-for-android-application/ 已翻译，中文链接如下：
https://github.com/weijianfeng/Translation-Project/blob/master/Project/1/Test%20coverage%20report%20for%20Android%20application.md
https://github.com/kvandermast/my-robolectric-app
https://github.com/aresLove/android-tech-frontier/tree/master/issue-7/%E4%BD%BF%E7%94%A8Robolectric%E5%92%8CAndroid%E7%94%9F%E6%88%90%E4%BB%A3%E7%A0%81%E8%A6%86%E7%9B%96%E7%8E%87%E6%8A%A5%E5%91%8A
http://www.jianshu.com/p/4b03123b4f81