Gradle 测试任务 - Gradle 1.6 和 Gradle 2.3 或更高版本
Gradle test task - Gradle 1.6 and with Gradle 2.3 or later
我有一个 Java 项目。
PS: 在我的项目中，我在[=中没有任何java program/source代码147=]。
- 此文件夹仅包含一个 blank.txt 文件。
我有两个不同的 Gradle 版本：
Gradle 1.6 和 Java 7（因为 Java 8 不兼容 Gradle 1.6 或任何小于 1.10 的版本，如果我是对的）。
另一个版本是：Gradle2.3和Java8.
同时使用上面提到的 Gradle 1.6 + Java7 OR Gradle 2.3 + Java 8 个版本 我的项目构建成功.
不过，我注意到一件事：在构建 运行 时，它会自动调用 "test" 任务（根据 Gradle 设计，测试任务 运行免费）；我在 Gradle 1.6 + Java7 运行 期间发现 --- 我看到以下输出。
:jar
:assemble
:compileTestJava UP-TO-DATE
:processTestResources
:testClasses
:test
:check
如您所见，它说我没有任何测试源代码（即 src/test/java 不包含任何源代码 或 没有任何新内容对于 Gradle 编译 这一次 可能与上次 gradle 运行 构建没有任何变化）这就是为什么 compileTestJava 任务在它前面显示 UP-TO-DATE。
但是，:test 任务显示 运行 成功。我在 test { .. } 任务中使用了 jacoco（代码覆盖率）部分，然后它实际上 运行 那部分（因为 test[=108= 前面没有 UP-TO-DATE ] 任务）。 Jacoco 部分未在我的项目的 build.gradle 中定义，但实际上它来自顶层 / GRADLE_HOME/init.d/some-common-top-level.gradle 文件（其中 test { ... 有 jacoco { ... } .. } 节）。
正如我上面提到的，test 任务没有说 UP-TO-DATE，因此，在 Gradle 构建过程完成后，我可以看到它已创建build/tmp/expandedArchives/org.jacoco.... 文件夹中的以下 folder/files 结构：
$ ls -ltr build/tmp/expandedArchives/
total 4
drwxr-xr-x+ 1 e020001 Domain Users 0 Jul 7 20:45 org.jacoco.agent-0.7.2.201409121644.jar_778m6tp3jrtvcetasufl59dmau
$ ls -ltr build/tmp/expandedArchives/org.jacoco.agent-0.7.2.201409121644.jar_778m6tp3jrtvcetasufl59dmau/
total 272
drwxr-xr-x+ 1 e020001 Domain Users 0 Jul 7 20:58 META-INF
-rwxr-xr-x 1 e020001 Domain Users 2652 Jul 7 20:58 about.html
-rwxr-xr-x 1 e020001 Domain Users 272311 Jul 7 20:58 jacocoagent.jar
drwxr-xr-x+ 1 e020001 Domain Users 0 Jul 7 20:58 org
当我 运行ning Gradle 2.3 和 Java8.
时，不会发生同样的情况
构建成功，但我没有得到 build/tmp/expandedArchives/org.jacoco.... 包含 jacocoagent.jar 文件的文件夹。
知道为什么 Gradle 2.3 没有创建这个 jacoco 特定的 .jar 文件。
使用 Gradle 2.3+Java8，以下输出在 :compileTestJava 前面显示 UP-TO-DATE和 :test 任务（对于 test 任务，Gradle 1.6 不是这种情况）。
我运行“gradle清理构建”。
:compileTestJava UP-TO-DATE
:compileTestGroovy UP-TO-DATE
:processTestResources
:testClasses
:test UP-TO-DATE
:check
我需要 Gradle 2.3 在 build/tmp/expandedArchives/org.jacoco..... 文件夹下生成这个 jacocoagent.jar 以便我可以在下游 Jenkins 作业中使用它（运行s 非单元测试），因为这个项目确实有一些集成测试，我正在从父主构建作业（运行s gradle clean build including test task) 在下游作业中，这样我就可以在启动 Tomcat 时将它传递给 TOMCAT JVM（这样我就可以获得 jacocoIT.exec 的代码覆盖率IT 测试）。但是，在我切换到 Gradle 2.3 之后，我没有 src/test/java 的所有项目......现在 jacocoagent.jar 没有被创建并且 copy 工件插件 尝试从父作业复制 .jar 文件时失败。
加一分：
使用 Gradle 1.6 + Java7，如果我 运行 gradle clean build，它会在里面成功创建 jacocoagent.jar build/tmp/expandedArchives/org.jacoco..... 文件夹但它以这种方式工作，只有当我 运行 gradle clean build 或“gradle 清理；gradle 测试".
如果我 运行 gradle 清理构建，然后删除 build/tmp 文件夹，现在只需 运行: gradle 测试，它在 :compileTestJava 和 :test 任务和不会创建 build/tmp/expandedArchives/org.jacoco.... 包含 jacocoagent.jar 文件的文件夹。
有关详细信息，我附上了配置文件 运行（即使用 --profile 选项），而 运行ning gradle 测试 任务 Gradle 1.6 + java 7.
我看到，在 html 文件中，当 test 任务是 运行 时，它首先根据 Gradle 流程逻辑调用 compileJava，然后测试任务，它还调用 depedencies --- :jacocoAgent（根据依赖项解析选项卡）：
但是,
with Gradle 2.3 + Java8, dependency Resolution / order and Task execution step is not same (or in the order as compared to Gradle 1.6) for generation or显示对 jacocoAgent 依赖项的任何引用，因为它甚至没有调用它。
运行 Gradle1.6 +Java7 测试任务 -i（或--info）选项显示了为什么它运行测试任务，即使我没有测试源代码，查看原因：
Note: Recompile with -Xlint:unchecked for details.
:processResources
Skipping task ':processResources' as it has no source files.
:processResources UP-TO-DATE
:classes
Skipping task ':classes' as it has no actions.
:compileTestJava
Skipping task ':compileTestJava' as it has no source files.
:compileTestJava UP-TO-DATE
:processTestResources
Executing task ':processTestResources' due to:
No history is available.
:testClasses
Skipping task ':testClasses' as it has no actions.
:test
file or directory '/my/workspace/project/build/classes/test', not found
Executing task ':test' due to:
No history is available.
file or directory '/my/workspace/project/build/classes/test', not found
Finished generating test XML results (0.001 secs)
Generating HTML test report...
Finished generating test html results (0.012 secs)
BUILD SUCCESSFUL
无论输入输出状态如何，都可以强制执行测试任务：
test{
outputs.upToDateWhen{false}
}
对于较早的 gradle 版本，您可以通过
确保 class 目录存在
task createTestClassesDir << {sourceSets.test.output.classesDir.mkdirs()}
test.dependsOn createTestClassesDir
总结：
使用Gradle 2.3，如果没有有效的.java/.groovy（或等等）测试代码，那么test任务甚至不会 运行 因此不会在 build/tmp/exapandedArchives/org.jacoco.xxx.. 文件夹深处的某处创建 jacocoagent.jar。
解决方案是在 allprojects { .... } 部分中包含以下内容（在顶层 $GRADLE_HOME/init.d/some-global-file.gradle）。我们所做的就是，如果 src/test/java（标准）或任何遗留文件夹结构（src/java，如果您的项目结构是这样的）没有任何有效的测试源代码，那么我们可以添加一个虚拟测试文件（DummyTestXYZ.java 或 groovy）并让测试任务 运行 生成 jacocoagent.jar（我们可以使用/绑定 Tomcat 选项来生成 jacoco 报告对于非单元 aka 集成测试）。这样，如果您的主要构建作业调用 downstream/child 作业来 运行 您的 IT 测试，它不会失败，因为它可以获取 jacocoagent.jar（从主要构建作业的工作区）作为测试任务将在 build/tmp/expandedArchives/org.jacoco.xx.x.xx..x 文件夹中创建 jacocoagent.jar（您可以在 Jenkins 中使用 Copy Artifact 插件）。
PS：改变if语句逻辑acc。到您自己的文件夹设置，即您要在哪个文件夹中创建 DummyTestXYZ.java 文件。在我们的例子中，所有新项目都使用 src/test/java（符合 Maven/Gradle 标准的标准文件夹结构），并且在新项目创建期间，我们将签入的有效样本单元测试添加到源代码管理中。因此，在下面的逻辑中，我们实际上忽略了在 src/test/java 存在的情况下创建此 DummyTestXYZ.java 并且仅当 src/test/java 文件夹不存在时才创建此文件项目中不存在（即这是一个具有遗留文件夹结构的项目）+ test/java（用于存储 JUnit 单元测试的遗留文件夹）没有 .java 程序 and/or if test/java 不存在然后先创建它然后创建虚拟文件。我知道，我们可以在 Jenkins 服务器上的某个位置上传 jacocoagent.jar 并在启动 Tomcat 时使用该文件来获取 IT 测试的代码覆盖率。我们添加的虚拟测试文件需要 junit:junit:4.10 或 4.11 库版本才能使 :compileTestJava 任务成功。
compileJava {
doLast {
def dirName = "${projectDir}/test/java"
if(!file( "${projectDir}/src/test/java" ).exists())
if(!file( dirName ).exists())
new File( dirName ).mkdirs()
if(file( dirName ).exists()) {
def javaCnt = new FileNameByRegexFinder().getFileNames(dirName, /.*\.java/).size()
if(javaCnt == 0) {
def f = new File( dirName , 'DummyTestXYZ.java' )
def w = f.newPrintWriter()
w.println('import org.junit.Test;')
w.println('')
w.println('public class DummyTestXYZ {')
w.println('@Test' )
w.println('public void test() {')
w.println('}')
w.println('}')
w.close()
}
}
}
}
test {
doFirst {
testResultsDirName = "test-results/UT"
testReportDirName = "tests/UT"
}
maxParallelForks = 5
forkEvery = 50
//ignoreFailures = true
// Following Jacoco section is required only in Jenkins
// But a developer can uncomment them if they want this feature to work for their
// Desktop local Gradle builds.
jacoco {
//Following vars works only with versions >= 1.7 version of Gradle
destinationFile = file("$buildDir/jacoco/UT/jacocoUT.exec")
}
doLast {
if (file("${projectDir}/test/java/DummyTestXYZ.java").exists()) {
println "++"
println "++"
println "++"
println "======================================================="
println "DEV Team – Please add valid Unit tests in this project."
println "======================================================="
println "++"
println "++"
println "++"
sleep(30 * 1000)
new File("${projectDir}/build/classes/test").deleteDir()
new File("${buildDir}/jacoco/UT").deleteDir()
new File("${buildDir}/test-results/UT").deleteDir()
delete "${projectDir}/test/java/DummyTestXYZ.java"
}
}
}
//Do the same (as above test code) for any other similar test tasks like integartionTest, acceptanceTest etc..
jacocoTestReport {
//cleaning any compile time generated (for ex: JiBx classes files) so that jacoco task won't fail for not finding the actual source files (.java/.groovy for the compile time generated .class files)
doFirst {
delete fileTree (dir: "${buildDir}/classes", include: "**/JiBX_*.class")
}
group = "Reporting"
description = "Generate Jacoco coverage reports after running tests."
//ignoreFailures = true
executionData = fileTree(dir: 'build/jacoco', include: '**/*.exec')
reports {
xml{
enabled true
//Following value is a file
destination "${buildDir}/reports/jacoco/xml/jacoco.xml"
}
csv.enabled false
html{
enabled true
//Following value is a folder
destination "${buildDir}/reports/jacoco/html"
}
}
sourceDirectories = files(['src/java','src/main/java', 'src/main/groovy'])
classDirectories = files('build/classes/main')
doLast {
if (file("${projectDir}/test/java/DummyTestXYZ.java").exists()) {
delete "${projectDir}/test/java/DummyTestXYZ.java"
}
}
}
我有一个 Java 项目。
PS: 在我的项目中，我在[=中没有任何java program/source代码147=]。
- 此文件夹仅包含一个 blank.txt 文件。
我有两个不同的 Gradle 版本：
Gradle 1.6 和 Java 7（因为 Java 8 不兼容 Gradle 1.6 或任何小于 1.10 的版本，如果我是对的）。
另一个版本是：Gradle2.3和Java8.
同时使用上面提到的 Gradle 1.6 + Java7 OR Gradle 2.3 + Java 8 个版本 我的项目构建成功.
不过，我注意到一件事：在构建 运行 时，它会自动调用 "test" 任务（根据 Gradle 设计，测试任务 运行免费）；我在 Gradle 1.6 + Java7 运行 期间发现 --- 我看到以下输出。
:jar
:assemble
:compileTestJava UP-TO-DATE
:processTestResources
:testClasses
:test
:check
如您所见，它说我没有任何测试源代码（即 src/test/java 不包含任何源代码 或 没有任何新内容对于 Gradle 编译 这一次 可能与上次 gradle 运行 构建没有任何变化）这就是为什么 compileTestJava 任务在它前面显示 UP-TO-DATE。
但是，:test 任务显示 运行 成功。我在 test { .. } 任务中使用了 jacoco（代码覆盖率）部分，然后它实际上 运行 那部分（因为 test[=108= 前面没有 UP-TO-DATE ] 任务）。 Jacoco 部分未在我的项目的 build.gradle 中定义，但实际上它来自顶层 / GRADLE_HOME/init.d/some-common-top-level.gradle 文件（其中 test { ... 有 jacoco { ... } .. } 节）。
正如我上面提到的，test 任务没有说 UP-TO-DATE，因此，在 Gradle 构建过程完成后，我可以看到它已创建build/tmp/expandedArchives/org.jacoco.... 文件夹中的以下 folder/files 结构：
$ ls -ltr build/tmp/expandedArchives/
total 4
drwxr-xr-x+ 1 e020001 Domain Users 0 Jul 7 20:45 org.jacoco.agent-0.7.2.201409121644.jar_778m6tp3jrtvcetasufl59dmau
$ ls -ltr build/tmp/expandedArchives/org.jacoco.agent-0.7.2.201409121644.jar_778m6tp3jrtvcetasufl59dmau/
total 272
drwxr-xr-x+ 1 e020001 Domain Users 0 Jul 7 20:58 META-INF
-rwxr-xr-x 1 e020001 Domain Users 2652 Jul 7 20:58 about.html
-rwxr-xr-x 1 e020001 Domain Users 272311 Jul 7 20:58 jacocoagent.jar
drwxr-xr-x+ 1 e020001 Domain Users 0 Jul 7 20:58 org
当我 运行ning Gradle 2.3 和 Java8.
时，不会发生同样的情况构建成功，但我没有得到 build/tmp/expandedArchives/org.jacoco.... 包含 jacocoagent.jar 文件的文件夹。
知道为什么 Gradle 2.3 没有创建这个 jacoco 特定的 .jar 文件。
使用 Gradle 2.3+Java8，以下输出在 :compileTestJava 前面显示 UP-TO-DATE和 :test 任务（对于 test 任务，Gradle 1.6 不是这种情况）。
我运行“gradle清理构建”。
:compileTestJava UP-TO-DATE
:compileTestGroovy UP-TO-DATE
:processTestResources
:testClasses
:test UP-TO-DATE
:check
我需要 Gradle 2.3 在 build/tmp/expandedArchives/org.jacoco..... 文件夹下生成这个 jacocoagent.jar 以便我可以在下游 Jenkins 作业中使用它（运行s 非单元测试），因为这个项目确实有一些集成测试，我正在从父主构建作业（运行s gradle clean build including test task) 在下游作业中，这样我就可以在启动 Tomcat 时将它传递给 TOMCAT JVM（这样我就可以获得 jacocoIT.exec 的代码覆盖率IT 测试）。但是，在我切换到 Gradle 2.3 之后，我没有 src/test/java 的所有项目......现在 jacocoagent.jar 没有被创建并且 copy 工件插件 尝试从父作业复制 .jar 文件时失败。
加一分：
使用 Gradle 1.6 + Java7，如果我 运行 gradle clean build，它会在里面成功创建 jacocoagent.jar build/tmp/expandedArchives/org.jacoco..... 文件夹但它以这种方式工作，只有当我 运行 gradle clean build 或“gradle 清理；gradle 测试".
如果我 运行 gradle 清理构建，然后删除 build/tmp 文件夹，现在只需 运行: gradle 测试，它在 :compileTestJava 和 :test 任务和不会创建 build/tmp/expandedArchives/org.jacoco.... 包含 jacocoagent.jar 文件的文件夹。
有关详细信息，我附上了配置文件 运行（即使用 --profile 选项），而 运行ning gradle 测试 任务 Gradle 1.6 + java 7.
我看到，在 html 文件中，当 test 任务是 运行 时，它首先根据 Gradle 流程逻辑调用 compileJava，然后测试任务，它还调用 depedencies --- :jacocoAgent（根据依赖项解析选项卡）：
但是,
with Gradle 2.3 + Java8, dependency Resolution / order and Task execution step is not same (or in the order as compared to Gradle 1.6) for generation or显示对 jacocoAgent 依赖项的任何引用，因为它甚至没有调用它。
运行 Gradle1.6 +Java7 测试任务 -i（或--info）选项显示了为什么它运行测试任务，即使我没有测试源代码，查看原因：
Note: Recompile with -Xlint:unchecked for details.
:processResources
Skipping task ':processResources' as it has no source files.
:processResources UP-TO-DATE
:classes
Skipping task ':classes' as it has no actions.
:compileTestJava
Skipping task ':compileTestJava' as it has no source files.
:compileTestJava UP-TO-DATE
:processTestResources
Executing task ':processTestResources' due to:
No history is available.
:testClasses
Skipping task ':testClasses' as it has no actions.
:test
file or directory '/my/workspace/project/build/classes/test', not found
Executing task ':test' due to:
No history is available.
file or directory '/my/workspace/project/build/classes/test', not found
Finished generating test XML results (0.001 secs)
Generating HTML test report...
Finished generating test html results (0.012 secs)
BUILD SUCCESSFUL
无论输入输出状态如何，都可以强制执行测试任务：
test{
outputs.upToDateWhen{false}
}
对于较早的 gradle 版本，您可以通过
确保 class 目录存在task createTestClassesDir << {sourceSets.test.output.classesDir.mkdirs()}
test.dependsOn createTestClassesDir
总结：
使用Gradle 2.3，如果没有有效的.java/.groovy（或等等）测试代码，那么test任务甚至不会 运行 因此不会在 build/tmp/exapandedArchives/org.jacoco.xxx.. 文件夹深处的某处创建 jacocoagent.jar。
解决方案是在 allprojects { .... } 部分中包含以下内容（在顶层 $GRADLE_HOME/init.d/some-global-file.gradle）。我们所做的就是，如果 src/test/java（标准）或任何遗留文件夹结构（src/java，如果您的项目结构是这样的）没有任何有效的测试源代码，那么我们可以添加一个虚拟测试文件（DummyTestXYZ.java 或 groovy）并让测试任务 运行 生成 jacocoagent.jar（我们可以使用/绑定 Tomcat 选项来生成 jacoco 报告对于非单元 aka 集成测试）。这样，如果您的主要构建作业调用 downstream/child 作业来 运行 您的 IT 测试，它不会失败，因为它可以获取 jacocoagent.jar（从主要构建作业的工作区）作为测试任务将在 build/tmp/expandedArchives/org.jacoco.xx.x.xx..x 文件夹中创建 jacocoagent.jar（您可以在 Jenkins 中使用 Copy Artifact 插件）。
PS：改变if语句逻辑acc。到您自己的文件夹设置，即您要在哪个文件夹中创建 DummyTestXYZ.java 文件。在我们的例子中，所有新项目都使用 src/test/java（符合 Maven/Gradle 标准的标准文件夹结构），并且在新项目创建期间，我们将签入的有效样本单元测试添加到源代码管理中。因此，在下面的逻辑中，我们实际上忽略了在 src/test/java 存在的情况下创建此 DummyTestXYZ.java 并且仅当 src/test/java 文件夹不存在时才创建此文件项目中不存在（即这是一个具有遗留文件夹结构的项目）+ test/java（用于存储 JUnit 单元测试的遗留文件夹）没有 .java 程序 and/or if test/java 不存在然后先创建它然后创建虚拟文件。我知道，我们可以在 Jenkins 服务器上的某个位置上传 jacocoagent.jar 并在启动 Tomcat 时使用该文件来获取 IT 测试的代码覆盖率。我们添加的虚拟测试文件需要 junit:junit:4.10 或 4.11 库版本才能使 :compileTestJava 任务成功。
compileJava {
doLast {
def dirName = "${projectDir}/test/java"
if(!file( "${projectDir}/src/test/java" ).exists())
if(!file( dirName ).exists())
new File( dirName ).mkdirs()
if(file( dirName ).exists()) {
def javaCnt = new FileNameByRegexFinder().getFileNames(dirName, /.*\.java/).size()
if(javaCnt == 0) {
def f = new File( dirName , 'DummyTestXYZ.java' )
def w = f.newPrintWriter()
w.println('import org.junit.Test;')
w.println('')
w.println('public class DummyTestXYZ {')
w.println('@Test' )
w.println('public void test() {')
w.println('}')
w.println('}')
w.close()
}
}
}
}
test {
doFirst {
testResultsDirName = "test-results/UT"
testReportDirName = "tests/UT"
}
maxParallelForks = 5
forkEvery = 50
//ignoreFailures = true
// Following Jacoco section is required only in Jenkins
// But a developer can uncomment them if they want this feature to work for their
// Desktop local Gradle builds.
jacoco {
//Following vars works only with versions >= 1.7 version of Gradle
destinationFile = file("$buildDir/jacoco/UT/jacocoUT.exec")
}
doLast {
if (file("${projectDir}/test/java/DummyTestXYZ.java").exists()) {
println "++"
println "++"
println "++"
println "======================================================="
println "DEV Team – Please add valid Unit tests in this project."
println "======================================================="
println "++"
println "++"
println "++"
sleep(30 * 1000)
new File("${projectDir}/build/classes/test").deleteDir()
new File("${buildDir}/jacoco/UT").deleteDir()
new File("${buildDir}/test-results/UT").deleteDir()
delete "${projectDir}/test/java/DummyTestXYZ.java"
}
}
}
//Do the same (as above test code) for any other similar test tasks like integartionTest, acceptanceTest etc..
jacocoTestReport {
//cleaning any compile time generated (for ex: JiBx classes files) so that jacoco task won't fail for not finding the actual source files (.java/.groovy for the compile time generated .class files)
doFirst {
delete fileTree (dir: "${buildDir}/classes", include: "**/JiBX_*.class")
}
group = "Reporting"
description = "Generate Jacoco coverage reports after running tests."
//ignoreFailures = true
executionData = fileTree(dir: 'build/jacoco', include: '**/*.exec')
reports {
xml{
enabled true
//Following value is a file
destination "${buildDir}/reports/jacoco/xml/jacoco.xml"
}
csv.enabled false
html{
enabled true
//Following value is a folder
destination "${buildDir}/reports/jacoco/html"
}
}
sourceDirectories = files(['src/java','src/main/java', 'src/main/groovy'])
classDirectories = files('build/classes/main')
doLast {
if (file("${projectDir}/test/java/DummyTestXYZ.java").exists()) {
delete "${projectDir}/test/java/DummyTestXYZ.java"
}
}
}