您可以在支持 Gradle 的 IDE 中打开此示例。

此示例展示了如何聚合多个 Java 子项目的测试结果。test-report-aggregation 插件在应用于发行版项目(例如 Android 应用程序或 WAR 子项目)时提供此功能。

此示例中的项目包含三个项目:applicationlistutilities。所有三个项目都应用了 java 插件,并且 application 在其 implementation 配置中使用了 listutilitiesapplication 子项目是此软件项目的最终发行版,并应用 test-report-aggregation 来执行测试结果聚合。

Test Report Aggregation 插件目前不适用于 com.android.application 插件。
application/build.gradle.kts
plugins {
    id("myproject.java-conventions")
    application
    id("test-report-aggregation") (1)
}

dependencies {
    implementation(project(":list"))
    implementation(project(":utilities"))
}

application {
    mainClass = "org.gradle.sample.Main"
}

tasks.check {
    dependsOn(tasks.named<TestReport>("testAggregateTestReport")) (2)
}
application/build.gradle
plugins {
    id 'myproject.java-conventions'
    id 'application'
    id 'test-report-aggregation' (1)
}

dependencies {
    implementation project(':list')
    implementation project(':utilities')
}

application {
    mainClass = 'org.gradle.sample.Main'
}

tasks.named('check') {
    dependsOn tasks.named('testAggregateTestReport', TestReport) (2)
}

如果存在 jvm-test-suite 插件,则 application 项目不需要额外的配置。

1 应用 test-report-aggregation 插件
2 可选:使聚合测试报告生成成为“check”生命周期阶段的一部分

聚合逻辑不会自动检查所有子项目的测试结果。相反,将选择发行版项目的运行时类路径的直接和传递项目依赖进行潜在的聚合。

对于名为“test”的默认测试套件,无需额外配置。类型为 TestReport 的聚合报告及其后备任务是基于 application 项目中存在的测试套件合成的。具有相同 testType 属性的测试套件将被聚合。

运行测试并生成报告

$ ./gradlew testAggregateTestReport

BUILD SUCCESSFUL
24 actionable tasks: 24 executed

现在可以在 application/build/reports/tests/unit-tests/aggregated-results 下找到聚合的 HTML 报告。

有关更多信息,请参阅Java 项目测试章节