Android 使用 jacoco 统计代码行覆盖率 无需安装运行
Posted Android小王
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Android 使用 jacoco 统计代码行覆盖率 无需安装运行相关的知识,希望对你有一定的参考价值。
android 使用 jacoco 统计代码行覆盖率 无需安装运行
前言
jacoco是Java Code Coverage的缩写,是Java代码覆盖率统计的主流工具之一。关于jacoco的原理介绍,在网上有很多文章,感兴趣的同学可以去找别的博客看看,这里不做赘述。
最近接到这个需求,需要提升代码单测覆盖率并统计上传,了解到的实现方式是jacoco+Squaretest插件,在网上查了不少的资料,不得不说网上大部分的资料都非常老了,gradle插件一般都是2.3的,导致很多类文件路径错误,浪费了我很多时间,就算有比较新的博文,也大都是需要安装运行之后从手机存储再提取相应的ec文件来执行分析才能得出结果,我们这边目标是有脚本直接可以执行获取相应的文件来统计并自动上传,所以那种需要运行之后再提取相应的文件解析不是很方便,而且这种方案在不同手机上可能还会带来各种问题,于是,在我经过一番实践后终于实现了无需运行只需执行gradle task便可得到覆盖率文件,决定分享一下,为日后有需求的同学节省一些时间!
正文
请根据以下步骤细心耐心进行配置,中间如果出现任何错误都会影响到最后覆盖率文件的生成!
1、项目 build.gradle
在项目的 build.gradle
中引入 jacoco core
依赖:
、、、
buildscript
repositories
、、、
maven url "https://oss.sonatype.org/content/repositories/snapshots"
dependencies
、、、
classpath 'com.android.tools.build:gradle:3.2.1' //可具体配置 本教程务必使用3.2以上
classpath "org.jacoco:org.jacoco.core:0.8.5"
、、、
2、jacoco-report.gradle
在项目根目录新建一个 jacoco-report.gradle
文件,其中主要定义了一个 Gradle 任务:jacocoCoverageTestReport。代码如下:
apply plugin: 'jacoco'
tasks.withType(Test)
jacoco.includeNoLocationClasses = true
ext
getFileFilter = ->
def jacocoSkipClasses = null
if (project.hasProperty('jacocoSkipClasses'))
jacocoSkipClasses = project.property('jacocoSkipClasses')
//忽略类文件配置
def fileFilter = ['**/R.class', '**/R$*.class', '**/BuildConfig.*', '**/Manifest*.*', '**/*$ViewInjector*.*']
if (jacocoSkipClasses != null)
fileFilter.addAll(jacocoSkipClasses)
return fileFilter
task jacocoTestReport(type: JacocoReport, dependsOn: ['testCoverageDebugUnitTest', 'createCoverageDebugCoverageReport'])
group = "Reporting"
description = "Generate Jacoco coverage reports"
reports
xml
enabled = true
xml.destination file("build/reports/jacoco/jacoco.xml")
html
enabled = true
html.destination file("build/reports/jacoco")
def fileFilter = project.getFileFilter()
//检测覆盖率的class所在目录(以项目class所在目录为准)
//gradle2.3 class所在目录
def coverageDebugTree = fileTree(dir: "$project.buildDir/intermediates/classes/coverageDebug", excludes: fileFilter)
//gradle3.2 class所在目录
def coverageDebugTreeNewGradle = fileTree(dir: "$project.buildDir/intermediates/javac/debug/compileDebugJavaWithJavac/classes", excludes: fileFilter)
def mainSrc = "$project.projectDir/src/main/java"
//设置需要检测覆盖率的目录
sourceDirectories = files([mainSrc])
//兼容gradle版本
classDirectories = files([coverageDebugTree, coverageDebugTreeNewGradle])
//以下路径也需要检查
executionData = fileTree(dir: project.buildDir, includes: [
'jacoco/testCoverageDebugUnitTest.exec', 'outputs/code-coverage/debugAndroidTest/connected/coverage.ec'
])
注意以上注释的位置,每一个配置务必仔细检查路径是否正确且存在!
3、 app/*module的build.gradle
在你需要统计的 app或者某 module 对应的 build.gradle
中进行 jacoco 任务配置:
引入 上面新建的 jacoco-report.gradle
;
添加 coverageDebug BuildType
。
代码如下:
apply plugin: 'com.android.library'
apply from: '../jacoco-report.gradle'
android
、、、
defaultConfig
、、、
testInstrumentationRunner 'androidx.test.runner.AndroidJUnitRunner'
lintOptions
、、、
abortOnError false
buildTypes
、、、
coverageDebug
minifyEnabled false
testCoverageEnabled true
testOptions
unitTests.all
jvmArgs '-noverify'
unitTests
includeAndroidResources = true
unitTests.returnDefaultValues = true
、、、
dependencies
、、、
testImplementation 'junit:junit:4.12'
//单元测试
androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0'
testImplementation 'org.robolectric:robolectric:4.3.1'
testImplementation "org.robolectric:shadows-multidex:4.3"
testImplementation 'org.hamcrest:hamcrest-all:1.3'
// power mockito
testImplementation 'org.mockito:mockito-core:2.8.9'
testImplementation "org.powermock:powermock-api-mockito2:1.7.4"
testImplementation "org.powermock:powermock-module-junit4:1.7.4"
testImplementation "org.powermock:powermock-module-junit4-rule:1.7.4"
testImplementation "org.powermock:powermock-classloading-xstream:1.7.4"
4、 测试用例
在需要测试的对应 module 的 src/test/ 目录下编写对应的代码测试用例,建议使用 Squaretest
插件生成,使用方式请自行搜索,基本没什么坑,这里不再赘述。
5、 运行 task jacocoTestReport
在 Android Studio 的 Gradle 任务窗格中,找到 project/module/Tasks/reporting/jacocoTestReport
这个任务,双击运行,即可生成代码行覆盖率报告。
5、 查看报告
打开 project/module/build/reports/jacoco/index.html
文件,即可查看各个代码文件的行覆盖率。
覆盖率报告用浏览器打开后一般如下:
6、 小花招:快速提升代码覆盖率
根据覆盖率报告将覆盖率低的类忽略,具体可查看步骤2代码的第一个注释处
、、、
//忽略类文件配置
def fileFilter = ['**/R.class', '**/R$*.class', '**/BuildConfig.*', '**/Manifest*.*', '**/*$ViewInjector*.*'
//继续添加想要被忽略的低覆盖率的类
'**/ClassA.class','**/ClassB.class'、、、
]
、、、
以上是关于Android 使用 jacoco 统计代码行覆盖率 无需安装运行的主要内容,如果未能解决你的问题,请参考以下文章
Android+jacoco实现代码覆盖率最正确的实现方式,没有之一!
Android+jacoco实现代码覆盖率最正确的实现方式,没有之一!