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

此示例演示了如何创建一个插件，该插件包含一个自定义 task，用于生成类似于 JVM 基础测试的内置 Test task 的测试事件。该插件通过包含的构建进行打包。

此示例旨在演示诸如 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 插件，它定义了一个生成测试事件的自定义 task。

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

consumer 需要 Java 21。

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

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

运行 gradle :consumer:run 以运行 Tooling API 客户端。客户端将运行 gradle test，如上所述，并打印出任何接收到的测试事件。

作为生态系统的平台提供商，您将创建自定义测试 task，并使用 TestEventReporter API 生成测试事件。

作为诸如 IDE 之类的工具集成商，您将使用 Tooling API 客户端来接收测试事件，并以适当的方式向用户显示它们。

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