您可以使用 IntelliJ 原生导入器 或 Eclipse Buildship 在 IDE 中打开这些示例。

本示例展示了如何创建一个包含自定义任务的插件，该任务会像内置的 Test 任务处理基于 JVM 的测试一样生成测试事件。该插件通过 included build 打包。

本示例旨在演示平台提供者（例如 Android 或 Kotlin Multiplatform）如何使用低级 API 生成测试事件。

build.gradle.kts
plugins {
    id("com.example.custom-test")
}

version = "1.0.2"
settings.gradle.kts
rootProject.name = "custom-test-task"
includeBuild("plugin")
includeBuild("consumer")
build.gradle
plugins {
    id 'com.example.custom-test'
}

version = '1.0.2'
settings.gradle
rootProject.name = 'custom-test-task'
includeBuild('plugin')
includeBuild('consumer')

本示例包含两部分

  • custom-test-task 插件，它定义了一个生成测试事件的自定义任务。

  • consumer 构建，它创建了一个 Tooling API 客户端来接收测试事件。

consumer 需要 Java 21。

运行 gradle test 来运行自定义测试任务。默认情况下，没有测试会失败，并且控制台日志中不会显示任何内容。

运行 gradle test --fail 来运行包含失败测试的自定义测试任务。控制台日志将显示测试事件。

运行 gradle :consumer:run 来运行 Tooling API 客户端。该客户端将像上面一样运行 gradle test，并打印出收到的所有测试事件。

作为生态系统提供的平台，您可以创建自定义测试任务并使用 TestEventReporter API 来生成测试事件。

作为工具集成者（例如 IDE），您可以使用 Tooling API 客户端接收测试事件，并将其以适当的方式显示给用户。

更多信息，请参阅Gradle 插件参考章节。