Kotlin Academy · 课时

版本目录

Q: 「版本目录」这节课中我会学到什么？

管理依赖项版本 你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

管理依赖项版本

第 4 / 4 课13 个步骤

版本目录 是 CoddyKit 上的免费 Kotlin Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Kotlin Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Kotlin Academy 课程共包含 4 节课。

版本分散的问题

在多模块项目中，依赖项版本会重复出现在许多构建文件中。更新一个库意味着要编辑许多地方，既容易出错，又难以保持一致。

什么是版本目录

版本目录会将依赖项坐标和版本集中在一个地方。Gradle 会生成类型安全的访问器，您可以从任何模块引用它。

libs.versions.toml 文件

默认目录位于 gradle/libs.versions.toml。其中包含版本、库、插件和捆绑包这几个部分。

[versions]
kotlin = "2.0.0"
coroutines = "1.8.1"

声明库

[libraries] 部分会将别名映射到坐标，并通过名称引用版本。

[libraries]
coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-core", version.ref = "coroutines" }
guava = { module = "com.google.guava:guava", version = "33.2.1-jre" }

在 build.gradle.kts 中使用库

通过生成的 libs 访问器引用目录条目。连字符会变为点号。

dependencies {
    implementation(libs.coroutines.core)
    implementation(libs.guava)
}

声明插件

[plugins] 部分会集中管理插件 id 和版本。

[plugins]
kotlin-jvm = { id = "org.jetbrains.kotlin.jvm", version.ref = "kotlin" }
serialization = { id = "org.jetbrains.kotlin.plugin.serialization", version.ref = "kotlin" }

应用目录中的插件

在 plugins { } 代码块中使用 alias 函数引用目录中的插件。

plugins {
    alias(libs.plugins.kotlin.jvm)
    alias(libs.plugins.serialization)
}

捆绑包

捆绑包可以将相关库组合在一起，这样您就能通过一个访问器添加它们。

[bundles]
testing = ["junit", "mockk"]

// build.gradle.kts:
// testImplementation(libs.bundles.testing)

类型安全和自动补全

由于 libs 是生成的代码，IDE 可以自动补全条目；如果您引用了不存在的别名，构建也会立即失败，这比使用原始字符串安全得多。

命名规则

别名使用连字符或点号作为分隔符，这些分隔符会映射到嵌套访问器。coroutines-core 会变成 libs.coroutines.core。请避免使用下划线。

跨模块共享

单个 TOML 文件会自动对每个模块可见。更新一次版本，所有模块都会采用新版本，这是目录的核心优势。

快速检查

在多模块项目中，版本目录的主要优势是什么？

在交互式课程中回答

回顾

版本目录让依赖项管理更加简单：

在 gradle/libs.versions.toml 中声明版本、库、插件和捆绑包
通过类型安全的 libs 访问器和 alias(...) 进行引用
编辑一次即可更新每个模块

Gradle 课程至此完成。

免费开始

用 AI 导师学习 Kotlin — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 51
课程: 203

免费开始学习查看完整课程

常见问题解答

「版本目录」课时是免费的吗？

是的 — 「版本目录」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Kotlin Academy 课程的其余内容，请升级到 CoddyKit PRO。 Kotlin Academy 课程共包含 4 节课。

「版本目录」这节课中我会学到什么？

管理依赖项版本你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Kotlin Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Kotlin Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「版本目录」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Kotlin Academy 课中编写并运行代码吗？

能。每节 Kotlin Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Kotlin Academy