Gradle项目中如何统一管理Kotlin版本

在Gradle多模块项目中，统一管理Kotlin版本是一个常见的需求。通过Gradle的约定插件(Convention Plugin)机制，我们可以实现版本号的集中管理，避免在各个子模块中重复声明。

核心实现方案

1. 约定插件中的版本定义

在约定插件中，可以通过kotlinToolingVersion获取当前Kotlin工具链版本：

import org.jetbrains.kotlin.gradle.plugin.kotlinToolingVersion

val kotlinVersion = kotlinToolingVersion

plugins {
    kotlin("jvm")
}

dependencies {
    // 使用BOM管理Kotlin相关依赖版本
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlinVersion"))
}

2. 插件版本管理

对于Kotlin编译器插件(如序列化插件)，最佳实践是不显式指定版本：

plugins {
    kotlin("plugin.serialization") // 自动使用Gradle内置版本
}

这种方式可以确保插件版本与Kotlin编译器版本自动保持兼容。

高级应用场景

版本目录(Version Catalog)集成

虽然约定插件无法直接向版本目录暴露变量，但可以通过以下方式间接实现：

1. 在gradle/libs.versions.toml中定义版本号：

[versions]
kotlin = "2.0.21"

2. 在约定插件中引用：

dependencies {
    val kotlinVersion = libs.versions.kotlin.get()
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlinVersion"))
}

技术原理说明

Gradle的插件系统有严格的加载顺序：

1. plugins块执行时，插件尚未完全加载
2. 因此无法在插件块中引用来自约定插件的变量
3. 这也是为什么建议将插件版本声明放在约定插件内部

最佳实践建议

1. 对于Kotlin标准库和扩展库，使用BOM(bill-of-materials)管理依赖版本
2. 对于编译器插件，尽量不指定版本以保持兼容性
3. 跨项目共享配置时，优先使用约定插件而非版本目录
4. 在大型项目中，可以将版本号提取到项目属性中统一管理

通过这种方式，可以确保项目中所有模块使用完全一致的Kotlin版本，避免因版本不一致导致的编译问题或运行时异常。