多模块Gradle项目使用自定义二进制插件遇问题求助

问题核心 #

核心矛盾在于Gradle预编译脚本对插件依赖的解析逻辑和普通模块不同，且你的插件发布时缺失插件ID与Maven坐标的映射配置，导致buildSrc中无法正确识别插件。

具体解决步骤 #

1. 补全插件项目的ID与坐标映射配置 #

在你的my-gradle-plugin项目的build.gradle中，通过gradlePlugin块明确插件ID与实现类、Maven坐标的关联，确保Gradle能通过插件ID找到对应依赖：

plugins {
    id 'java-gradle-plugin'
    id 'maven-publish'
}

// 声明插件ID与实现类的映射
gradlePlugin {
    plugins {
        pluginA {
            id = 'com.company.plugin.a'
            implementationClass = 'com.company.plugin.PluginA' // 替换为你的PluginA实际类路径
        }
        commonPlugin {
            id = 'com.company.plugin.common'
            implementationClass = 'com.company.plugin.CommonPlugin'
        }
        // 其他类型插件同理添加
    }
}

publishing {
    publications {
        maven(MavenPublication) {
            from components.java
            // 确认发布坐标正确
            groupId = 'com.company'
            artifactId = 'my-gradle-plugin'
            version = '1.2.3'
        }
    }
    repositories {
        mavenLocal() // 测试用本地仓库
        maven {
            url = uri('http://your-internal-nexus/repository/maven-releases/') // 正式仓库地址
        }
    }
}

配置完成后重新发布插件到对应仓库。

2. 配置buildSrc的依赖与仓库 #

在buildSrc/build.gradle中添加插件依赖和仓库配置，让buildSrc能拉取到你的自定义插件：

repositories {
    mavenLocal()
    maven {
        url = uri('http://your-internal-nexus/repository/maven-releases/')
    }
}

dependencies {
    // 引入自定义插件的完整坐标
    implementation 'com.company:my-gradle-plugin:1.2.3'
}

3. 在预编译脚本中无版本引入插件 #

在buildSrc/src/main/groovy/project-conventions.groovy中直接使用插件ID引入，无需带版本：

plugins {
    id 'com.company.plugin.a'
}

// 这里添加统一的项目约定配置

关键说明 #

• 预编译脚本不允许带版本引入插件，版本由buildSrc的依赖管理统一控制，这是第一种尝试失败的原因。
• 第二种尝试失败是因为插件未声明ID与坐标的映射，Gradle无法通过com.company.plugin.a找到对应的com.company:my-gradle-plugin依赖，必须通过gradlePlugin块完成关联。
• 确保~/.gradle/init.gradle或buildSrc的仓库配置能正常访问插件仓库，避免依赖拉取失败。

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