复合构建下无法在root build.gradle.kts中使用apply<Plugin>()求助

复合构建下无法直接用apply<DetektConventionPlugin>()生效，核心原因是主项目类路径默认不包含复合构建里插件模块的代码——而buildSrc是Gradle自动纳入类路径的特殊目录，所以能直接生效。以下是不用buildSrc的解决步骤：

1. 配置插件模块的构建脚本 #

假设你的插件模块名为detekt-convention-plugin，修改其build.gradle.kts，将它配置为标准Gradle插件项目：

plugins {
    `kotlin-dsl` // 必须应用该插件来开发Gradle插件
}

repositories {
    mavenCentral()
    gradlePluginPortal()
}

dependencies {
    implementation(gradleApi()) // 引入Gradle核心API
    implementation(libs.findLibrary("detekt-gradle-plugin").get()) // 依赖Detekt Gradle插件
}

// 注册自定义插件，生成Gradle可识别的插件元数据
gradlePlugin {
    plugins {
        create("detektConvention") {
            id = "your.custom.id.detekt-convention" // 自定义唯一插件ID
            implementationClass = "DetektConventionPlugin" // 插件类全限定名（如果有包名需补充，比如com.example.DetektConventionPlugin）
        }
    }
}

2. 在主项目settings中引入插件模块 #

在主项目的settings.gradle.kts里，通过includeBuild将插件模块加入复合构建：

includeBuild("detekt-convention-plugin") // 替换为你的插件模块相对路径

3. 在主项目中应用插件 #

方式一：通过插件ID应用（推荐） #

这是Gradle插件的标准用法，无需额外类路径配置：

plugins {
    id("your.custom.id.detekt-convention")
}

方式二：类型安全的apply<Class>()（需额外配置） #

如果坚持要用apply<DetektConventionPlugin>()，需将插件模块加入主项目的buildscript类路径：

buildscript {
    dependencies {
        // 引用复合构建中的插件模块（需对应插件模块配置的groupId、artifactId、version）
        classpath("your.custom.id:detekt-convention:1.0.0")
        // 若插件是复合构建子项目，也可直接用classpath(project(":detekt-convention-plugin"))
    }
}

apply<DetektConventionPlugin>()

额外注意事项 #

• 插件类包名要准确：如果DetektConventionPlugin在特定包下（比如com.example.conventions），implementationClass必须填写完整的全限定名。
• 路径校验：插件代码中$rootDir指向主项目根目录，确保config/detekt等文件路径正确。
• 版本一致性：插件模块的libs.versions.toml中Detekt版本需和主项目保持一致。

内容的提问来源于stack exchange，提问作者Jerry Okafor