Gradle 7.3如何将自定义插件作为子项目加入其他项目构建类路径

该需求完全可以在Gradle 7.3版本实现，无法正常引入插件的核心原因是复合构建配置规则、预编译插件的目录/命名规则、构建脚本层级配置三个环节存在错误，按照以下步骤配置即可正常使用。

1. 修正全局构建层级 #

多项目构建的settings.gradle/settings.gradle.kts必须放在整个仓库的最外层根目录，不要放在ProjectA内部，在根settings中配置build-logic为插件类包含构建：

// 根目录/settings.gradle.kts
pluginManagement {
    includeBuild("build-logic") // 将build-logic作为插件提供方纳入构建类路径
    repositories {
        gradlePluginPortal()
        mavenCentral()
    }
}
rootProject.name = "your-project-root"
include("ProjectA") // 统一纳入业务子项目

2. 修正build-logic子项目结构与配置 #

预编译脚本插件对源码路径有强制要求，当前目录层级不符合kotlin-dsl插件的默认识别规则，同时普通功能类不要使用.gradle.kts后缀，否则会被识别为独立插件脚本导致编译异常。
调整后的build-logic标准结构：

build-logic
├── build.gradle.kts
└── src
    └── main
        ├── java
        │   ├── SomeJavaClass.java
        │   └── SomeJavaClass2.java
        └── kotlin
            ├── MyPluginClass.gradle.kts // 仅插件入口脚本使用.gradle.kts后缀
            ├── MyTaskClass.kt // 自定义任务类为普通Kotlin类，使用.kt后缀
            └── Utils.kt // 工具类为普通Kotlin类，使用.kt后缀

build-logic自身的构建脚本配置如下，必须引入kotlin-dsl插件获得预编译脚本、Kotlin/Java混合编译能力：

// build-logic/build.gradle.kts
plugins {
    `kotlin-dsl`
}

repositories {
    gradlePluginPortal()
    mavenCentral()
}

// 插件自身的第三方依赖在此处声明即可
dependencies {
    // 例：implementation("com.android.tools.build:gradle:7.2.2")
}

3. 编写插件逻辑 #

在MyPluginClass.gradle.kts中实现插件入口，同模块下的Kotlin类、Java类可以直接引用，不需要额外配置类路径：

// build-logic/src/main/kotlin/MyPluginClass.gradle.kts
import org.gradle.api.Plugin
import org.gradle.api.Project

class MyCustomPlugin : Plugin<Project> {
    override fun apply(project: Project) {
        // 注册自定义任务、调用工具类/Java类逻辑均可正常执行
        project.tasks.register("myCustomTask", MyTaskClass::class.java)
        val utilResult = Utils.someUtilMethod()
        val javaResult = SomeJavaClass.someJavaMethod()
    }
}

预编译插件的默认ID为入口脚本的文件名（去掉.gradle.kts后缀），上述配置对应的插件ID就是MyPluginClass。

4. 在ProjectA中引用插件 #

不需要再配置原来的classpath("com.my:custom.plugin:version")依赖，直接在ProjectA的构建脚本中通过plugins块引入即可：

// ProjectA/build.gradle.kts
plugins {
    id("MyPluginClass")
}

// 引入后即可正常使用插件提供的任务、扩展能力

• 不要将build-logic作为普通子项目通过include引入，必须放在pluginManagement块内通过includeBuild声明，否则其产物不会被加入主构建的插件类路径
• 非插件入口的Kotlin文件绝对不能使用.gradle.kts后缀，这类后缀的文件会被kotlin-dsl插件识别为独立的预编译插件，导致普通类编译失败、类找不到
• Gradle 7.3内置的kotlin-dsl插件已经默认支持Java/Kotlin混合编译，不需要额外配置Java编译任务，只要将Java文件放在src/main/java路径下即可被正常识别和引用
• 整个仓库只能有一个根settings文件，所有子项目、包含构建都要在根settings中声明，不要在子项目内嵌套settings文件破坏构建层级

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