Gradle 1.12用户指南翻译——第三十四章. JaCoCo 插件
2015-06-29 09:08
441 查看
本文由CSDN博客万一博主翻译,其他章节的翻译请参见:
http://blog.csdn.net/column/details/gradle-translation.html
翻译项目请关注Github上的地址:
https://github.com/msdx/gradledoc/tree/1.12。
直接浏览双语版的文档请访问:
http://gradledoc.qiniudn.com/1.12/userguide/userguide.html。
另外,Android 手机用户可通过我写的一个程序浏览文档,带缓存功能的,目前0.2.1版本兼容 android 2.2以上系统,地址如下:
http://www.wandoujia.com/apps/com.githang.gradledoc
翻译不易,转载请注明本文在CSDN博客上的出处:
http://blog.csdn.net/maosidiaoxian/article/details/46646311
关于我对Gradle的翻译,以Github上的项目及http://gradledoc.qiniudn.com 上的文档为准。如有发现翻译有误的地方,将首先在以上两个地方更新。因时间精力问题,博客中发表的译文基本不会同步修改。
JaCoCo 插件目前还是孵化中状态。请务必注意,在以后的
Gradle 版本中,DSL 和其他配置可能会有所改变。
JaCoCo 插件通过集成JaCoCo为
Java 代码提供了代码覆盖率指标。
要想开始,请将 JaCoCo 插件应用于你想要计算代码覆盖率的项目中。
示例 34.1. 应用 JaCoCo 插件
如果 Java 插件也被应用于你的项目,那么会创建一个名为
HTML 报告。
JaCoCo 插件添加一个名为
扩展,这个扩展允许在你的构建中配置 JaCoCo 所使用的默认值。
示例 34.2. 配置 JaCoCo 插件设置
表 34.1. JaCoCo 属性的 Gradle 默认值
Gradle 类型
示例 34.3. 配置测试任务
JaCoCo 插件添加了一个
JaCoCo 中的测试任务的一些特定属性。
示例 34.4. 配置测试任务
表 34.2. JaCoCo 任务扩展的默认值
虽然
JaCoCo 插件得到增强。也就意味着,任何fork Java 进程的任务都可以用于生成覆盖率信息。
例如,你可以配置您的构建使用
示例 34.5. 使用 application 插件来生成代码覆盖率数据
注: 此示例中的代码可以在Gradle
的二进制分发包及源代码分发包中的
示例 34.6. 由 applicationCodeCoverageReport 生成的覆盖率报告
构建布局
对于同时也配置使用了 Java 插件的项目,JaCoCo 插件会自动添加以下任务:
表 34.3. JaCoCo 插件 - 任务
JaCoCo 插件添加了下列的依赖配置:
表34.4. JaCoCo 插件 - 依赖配置
http://blog.csdn.net/column/details/gradle-translation.html
翻译项目请关注Github上的地址:
https://github.com/msdx/gradledoc/tree/1.12。
直接浏览双语版的文档请访问:
http://gradledoc.qiniudn.com/1.12/userguide/userguide.html。
另外,Android 手机用户可通过我写的一个程序浏览文档,带缓存功能的,目前0.2.1版本兼容 android 2.2以上系统,地址如下:
http://www.wandoujia.com/apps/com.githang.gradledoc
翻译不易,转载请注明本文在CSDN博客上的出处:
http://blog.csdn.net/maosidiaoxian/article/details/46646311
关于我对Gradle的翻译,以Github上的项目及http://gradledoc.qiniudn.com 上的文档为准。如有发现翻译有误的地方,将首先在以上两个地方更新。因时间精力问题,博客中发表的译文基本不会同步修改。
第三十四章. JaCoCo 插件
JaCoCo 插件目前还是孵化中状态。请务必注意,在以后的Gradle 版本中,DSL 和其他配置可能会有所改变。
JaCoCo 插件通过集成JaCoCo为
Java 代码提供了代码覆盖率指标。
34.1.
入门
要想开始,请将 JaCoCo 插件应用于你想要计算代码覆盖率的项目中。示例 34.1. 应用 JaCoCo 插件
build.gradle
apply plugin: "jacoco"
如果 Java 插件也被应用于你的项目,那么会创建一个名为
jacocoTestReport的新任务,该新任务依赖于
test任务。该报告可以在
$buildDir
/reports/jacoco/test 中看到。默认情况下,会生成一个HTML 报告。
34.2.
配置 JaCoCo 插件
JaCoCo 插件添加一个名为jacoco类型为
JacocoPluginExtension的project
扩展,这个扩展允许在你的构建中配置 JaCoCo 所使用的默认值。
示例 34.2. 配置 JaCoCo 插件设置
build.gradle
jacoco toolVersion = "0.6.2.201302030002" reportsDir = file("$buildDir/customJacocoReportDir") }
表 34.1. JaCoCo 属性的 Gradle 默认值
Property | Gradle 默认值 |
reportsDir | "$buildDir/reports/jacoco" |
34.3.
JaCoCo 报告配置
JacocoReport任务可以用于生成不同格式的代码覆盖率报告。它实现了标准的
Gradle 类型
Reporting,并呈现了一个
JacocoReportsContainer类型的报告容器。
示例 34.3. 配置测试任务
build.gradle
jacocoTestReport { reports xml.enabled false csv.enabled false html.destination "${buildDir}/jacocoHtml" } }
34.4.
JaCoCo 的特定任务配置
JaCoCo 插件添加了一个JacocoTaskExtension扩展到
Test类型的所有任务中。该扩展允许配置
JaCoCo 中的测试任务的一些特定属性。
示例 34.4. 配置测试任务
build.gradle
test { jacoco append = false destinationFile = file("$buildDir/jacoco/jacocoTest.exec") classDumpFile = file("$buildDir/jacoco/classpathdumps") } }
表 34.2. JaCoCo 任务扩展的默认值
Property | Gradle 默认值 |
enabled | true |
destPath | $buildDir/jacoco |
append | true |
includes | [] |
excludes | [] |
excludeClassLoaders | [] |
sessionId | auto-generated |
dumpOnExit | true |
output | Output.FILE |
address | - |
port | - |
classDumpPath | - |
jmx | false |
Test的所有任务会在
java插件被配置使用时会自动增强以提供覆盖率信息,但是任何实现了
JavaForkOptions的任务都可以通过
JaCoCo 插件得到增强。也就意味着,任何fork Java 进程的任务都可以用于生成覆盖率信息。
例如,你可以配置您的构建使用
application插件来生成代码覆盖率。
示例 34.5. 使用 application 插件来生成代码覆盖率数据
build.gradle
apply plugin: "application" apply plugin: "jacoco" mainClassName = "org.gradle.MyMain" jacoco { applyTo run } task applicationCodeCoverageReport(type:JacocoReport){ executionData run sourceSets sourceSets.main }
注: 此示例中的代码可以在Gradle
的二进制分发包及源代码分发包中的
samples/testing/jacoco/application中找到。
示例 34.6. 由 applicationCodeCoverageReport 生成的覆盖率报告
构建布局
application build jacoco run.exec reports/jacoco/applicationCodeCoverageReport/html/ index.html
34.5.
任务
对于同时也配置使用了 Java 插件的项目,JaCoCo 插件会自动添加以下任务:表 34.3. JaCoCo 插件 - 任务
任务名称 | 依赖于 | 类型 | 描述 |
jacocoTestReport | - | JacocoReport | 为测试任务生成代码覆盖率报告。 |
34.6.
依赖管理
JaCoCo 插件添加了下列的依赖配置:表34.4. JaCoCo 插件 - 依赖配置
名称 | 意义 |
jacocoAnt | 用于运行JacocoReport和 JacocoMerge任务的 JaCoCo Ant 库。 |
jacocoAgent | 用于测试位于test下的代码的 JaCoCo 客户端库。 |
相关文章推荐
- 《实体解析与信息质量》 - 2.2.0 总结
- Gradle 1.12用户指南翻译——第三十四章. JaCoCo 插件
- .ftl文件 是什么文件 Freemarker
- [转]加快npm的下载速度
- 【Spring学习笔记-MVC-12】Spring MVC视图解析器之ResourceBundleViewResolver
- js报错 版本问题
- C语言知识总结
- 游戏设计的艺术:一本透镜的书——第二十一章 有些游戏是和其他玩家一起玩的
- 通过ulimit改善linux系统性能(摘自IBM)
- 小米路由器被曝“劫持”404页面
- 【MAC使用技巧】QuickTime Player使用技巧
- 机器学习系列丛书
- (一)Redis 基础 - 安装
- Linux中CPU与内存性能监测
- .NET平台开源项目速览(5)深入使用与扩展SharpConfig组件
- 简介Linux中cp和mv搭配{,}在shell当中的用法
- 黑马程序员——网络编程
- 使用jquery操作session方法分享
- iOS: 如何正确的绘制1像素的线
- C++类型转换