如何在自定义Gradle插件中获取PluginDependency实例？

问题背景 #

在自定义Gradle插件中直接调用apply()方法应用第三方插件（如org.jetbrains.kotlin.plugin.compose）时，会触发“找不到插件”的错误——这是因为Gradle默认未将目标插件的依赖纳入构建脚本的classpath，必须手动在根项目build.gradle的plugins{}块中声明依赖。本文介绍如何在自定义插件内部完成依赖配置，无需用户手动操作。

解决方案1：通过构建脚本classpath配置依赖 #

这是最稳定的实现方式，先为目标项目的构建脚本添加仓库和插件依赖，再执行插件应用：

class MyPlugin : Plugin<Project> {
    override fun apply(target: Project) {
        // 1. 配置构建脚本仓库，确保能拉取到目标插件
        target.buildscript.repositories {
            gradlePluginPortal() // Gradle官方插件仓库
            mavenCentral()
            google() // Kotlin Compose插件依赖此仓库
        }

        // 2. 添加目标插件的classpath依赖（替换为对应版本）
        target.buildscript.dependencies {
            classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.20")
            classpath("org.jetbrains.kotlin:kotlin-compose-plugin:1.5.1")
        }

        // 3. 安全应用目标插件
        target.apply(plugin = "org.jetbrains.kotlin.plugin.compose")
    }
}

解决方案2：使用Gradle Plugins DSL #

如果希望遵循Gradle的Plugins DSL风格，可通过PluginDependenciesSpec声明插件依赖后再应用，但需确保项目已配置对应仓库：

class MyPlugin : Plugin<Project> {
    override fun apply(target: Project) {
        // 声明插件依赖（指定版本，暂不自动应用）
        target.plugins.run {
            id("org.jetbrains.kotlin.plugin.compose") version "1.5.1" apply false
        }
        // 手动应用插件
        target.plugins.apply("org.jetbrains.kotlin.plugin.compose")
    }
}

注意：此方式依赖项目settings.gradle中pluginManagement配置的仓库（如gradlePluginPortal()）。若用户项目未配置，仍会出现依赖找不到的问题，建议结合方案1的仓库配置，或在插件中修改pluginManagement（需注意权限问题）。

关键注意事项 #

• 版本管理：避免硬编码版本号，可将版本定义为常量，或提供扩展让用户自定义版本，减少版本冲突风险。
• 仓库适配：不同插件托管在不同仓库，需根据目标插件的要求添加对应仓库（如Google仓库、Maven Central等）。
• 冲突处理：若用户项目已添加同插件的依赖，可能出现版本冲突，可使用force关键字强制指定版本，或通过Gradle版本对齐机制统一版本。

内容的提问来源于stack exchange，提问作者江祖贇