一个简单的 Android 版本目录(Version catalog)实现指南_android version catalogs

一个简单的 Android 版本目录实现指南

使用 TOML 格式
在本文中，我们将探讨版本目录以及如何实现它。

版本目录

Gradle 版本目录使您能够以可扩展的方式添加和维护依赖项和插件。因此，不必在各个构建文件中硬编码依赖项名称和版本，而是在目录中定义它们，并在所有模块中使用。

实现

要实现版本目录，我们可以在 settings.gradle 文件的 dependencyResolutionManagement 块中定义目录（查看此链接以了解更多详细信息），但我们将使用 TOML 格式来实现它…

https://docs.gradle.org/current/userguide/platforms.html

1- 创建一个版本目录文件

在根项目的 gradle 文件夹中，创建一个名为 libs.versions.toml 的文件。Gradle 默认在 libs.versions.toml 文件中查找目录，因此建议使用这个默认名称。

2- 定义您的版本、库和插件…

在 libs.versions.toml 中，我们可以定义我们的表…"

[versions]
kotlin = "1.8.10"
compose = '1.4.0'
material3 = '1.1.0-rc01'
...

[libraries]
compose-ui = { module = "androidx.compose.ui:ui", version.ref = "compose" }
compose-material3 = { module = "androidx.compose.material3:material3", version.ref = "material3" }
...

[plugins]
kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
...
1
2
3
4
5
6
7
8
9
10
11
12
13
14

基本上，[versions] 和 [libraries] 是一组键/值对（如 kotlin = "1.8.10"）的集合，称为 Tables…

https://toml.io/en/v1.0.0#table

这些表将从所有构建文件的libs.table.key处访问，因此我们稍后将在构建文件中使用它们。

请注意，我们使用了版本引用（version.ref = "xxx"）而不是硬编码版本。这样可以使我们的版本可重复使用