对于构建 Gradle 插件或与 Gradle 集成的工具的项目,Gradle 提供了特殊的依赖表示法。

使用这些依赖可以确保与 Gradle 内部 API 的兼容性,同时简化插件和构建逻辑的开发。

Gradle API 依赖

您可以使用 DependencyHandler.gradleApi() 方法声明对当前版本 Gradle API 的依赖。这在您开发自定义 Gradle tasks 或 plugins 时非常有用

build.gradle.kts
dependencies {
    implementation(gradleApi())
}
build.gradle
dependencies {
    implementation gradleApi()
}

Gradle TestKit 依赖

您可以使用 DependencyHandler.gradleTestKit() 方法声明对当前版本 Gradle 的 TestKit API 的依赖。这对于编写和执行 Gradle 插件和构建脚本的功能测试非常有用

build.gradle.kts
dependencies {
    testImplementation(gradleTestKit())
}
build.gradle
dependencies {
    testImplementation gradleTestKit()
}

TestKit 章通过示例解释了 TestKit 的使用。

本地 Groovy 依赖

您可以使用 DependencyHandler.localGroovy() 方法声明对 Gradle 分发包中包含的 Groovy 的依赖。这在您使用 Groovy 开发自定义 Gradle tasks 或 plugins 时非常有用

build.gradle.kts
dependencies {
    implementation(localGroovy())
}
build.gradle
dependencies {
    implementation localGroovy()
}