多项目场景下如何封装Gradle插件的版本管理？

AI 小北

2026-8-3

问题

我有多个独立仓库/项目（如app1、app2、app3），它们都依赖我的base包中的共享功能。
这些项目还使用各种第三方依赖（例如app1和app3使用Spring，所有项目都使用kotlinx-serialization）。我希望同步所有第三方依赖的版本，确保使用base包的项目都采用相同版本的第三方依赖，但不想给未使用相关依赖的项目引入新依赖（比如app2不使用Spring）。

已尝试的解决方案

对于库，我通过Gradle platform解决了这个问题——在base包中指定版本，然后将platform作为依赖添加到各项目中，之后只需按名称添加依赖（如implementation("org.springframework.boot:some-package")），无需指定版本号，因为会使用platform中提供的版本。
但对于插件，我还没能解决这个问题。许多库附带插件，插件版本自然应与库版本一致。我尝试了多种方法，包括编写独立插件，但都无效。

当前最优思路

我在独立插件的依赖中添加了implementation("org.springframework.boot:spring-boot-gradle-plugin:3.0.2")，然后在独立插件中添加了以下代码：

class BasePlugin : Plugin<Project> {
    override fun apply(target: Project) {
        target.plugins.apply("org.springframework.boot")
    }
}

这能正常工作，会以正确版本将插件应用到主项目，但存在两个主要问题：
a) 现在所有项目都会应用Spring插件，包括不使用Spring的app2。
b) 我需要管理很多插件，但不知道如何获取大多数插件的完整实现字符串。我是通过在插件平台上查找插件ID，然后查看legacy plugin application部分找到"org.springframework.boot:spring-boot-gradle-plugin:3.0.2"的，这似乎不是正确的做法。

我只想在一个中心位置管理多个项目/仓库的插件和库版本——这感觉是一个相当基础的需求，为什么这么难实现？

解决方案

1. 用Gradle官方的`pluginManagement`集中管理插件版本

这是Gradle推荐的集中管理插件版本的方案，完全替代手动硬编码版本的方式：
在根项目的settings.gradle.kts中配置：

pluginManagement {
    repositories {
        gradlePluginPortal()
        mavenCentral()
    }
    plugins {
        // 集中定义所有插件的版本
        val springBootVersion = "3.0.2"
        val kotlinSerializationVersion = "1.8.20"
        
        id("org.springframework.boot") version springBootVersion
        id("org.jetbrains.kotlin.plugin.serialization") version kotlinSerializationVersion
        // 其他需要统一版本的插件...
    }
    // 将版本常量暴露给所有项目，方便后续复用
    extra["springBootVersion"] = springBootVersion
}

之后各个项目应用插件时，只需写插件ID即可，无需指定版本：

plugins {
    id("org.springframework.boot")
}

2. 拆分自定义Base插件为功能模块

把原来的单一Base插件拆分为多个职责明确的子插件，让项目按需引入：

BaseCorePlugin：包含所有项目通用的配置（如kotlinx-serialization插件应用、base平台依赖引入等）
BaseSpringPlugin：依赖BaseCorePlugin，同时添加Spring相关插件和基础配置

示例代码：

BaseCorePlugin

class BaseCorePlugin : Plugin<Project> {
    override fun apply(target: Project) {
        // 应用所有项目都需要的kotlinx-serialization插件
        target.plugins.apply("org.jetbrains.kotlin.plugin.serialization")
        // 引入base平台依赖，统一管理库版本
        target.dependencies.add("implementation", platform("com.your-group:base-platform:1.0.0"))
        // 其他通用配置（如编码、JDK版本等）
    }
}

BaseSpringPlugin

class BaseSpringPlugin : Plugin<Project> {
    override fun apply(target: Project) {
        // 先应用核心插件
        target.plugins.apply(BaseCorePlugin::class.java)
        // 仅给需要的项目应用Spring Boot插件
        target.plugins.apply("org.springframework.boot")
        // 可选：添加Spring基础依赖（无需版本，由platform统一管理）
        target.dependencies.add("implementation", "org.springframework.boot:spring-boot-starter")
    }
}

然后在自定义插件的build.gradle.kts中注册这些子插件：

plugins {
    `java-gradle-plugin`
    kotlin("jvm") version "1.8.20"
}

gradlePlugin {
    plugins {
        create("baseCore") {
            id = "com.your-group.base-core"
            implementationClass = "com.yourgroup.BaseCorePlugin"
        }
        create("baseSpring") {
            id = "com.your-group.base-spring"
            implementationClass = "com.yourgroup.BaseSpringPlugin"
        }
    }
}

repositories {
    gradlePluginPortal()
    mavenCentral()
}

3. 项目按需引入插件

app1/app3（需要Spring）：

plugins {
    id("com.your-group.base-spring")
}

dependencies {
    implementation("org.springframework.boot:spring-boot-starter-web")
    implementation("com.your-group:base")
}

app2（不需要Spring）：

plugins {
    id("com.your-group.base-core")
}

dependencies {
    implementation("com.your-group:base")
}

4. 插件坐标的正确获取方式

不需要手动查找legacy坐标，直接在pluginManagement中用插件ID+版本即可。如果自定义插件需要依赖某插件的API（如扩展Spring Boot插件功能），可以通过集中管理的版本常量引入：

dependencies {
    implementation("org.springframework.boot:spring-boot-gradle-plugin:${rootProject.extra["springBootVersion"]}")
}

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

多项目场景下如何封装Gradle插件的版本管理？

当前最优思路 #

1. 用Gradle官方的pluginManagement集中管理插件版本 #

2. 拆分自定义Base插件为功能模块 #