? /??前言? /

在軟件開發(fā)中，依賴管理是一個(gè)至關(guān)重要的方面。合理的依賴版本控制有助于確保項(xiàng)目的穩(wěn)定性、安全性和可維護(hù)性。

Gradle版本目錄（Version Catalogs）是 Gradle 構(gòu)建工具的一個(gè)強(qiáng)大功能，它為項(xiàng)目提供了一種集中管理依賴版本的方式，使得團(tuán)隊(duì)協(xié)作更為高效。

/??什么是版本目錄？/

Gradle版本目錄是 Gradle 6.8 版本引入的一項(xiàng)新功能，它允許開發(fā)者將項(xiàng)目中使用的所有第三方依賴的版本信息集中管理在一個(gè)地方。

通過定義一個(gè)版本目錄，你可以在一個(gè)文件中指定所有依賴的版本號，而不必在每個(gè)模塊或構(gòu)建文件中重復(fù)聲明。

/??示例??/

1. 新建一個(gè)空項(xiàng)目

首先創(chuàng)建一個(gè)空白的 Android 項(xiàng)目，默認(rèn)情況下我們的 Gradle 文件如下：

可以看到所有的依賴都是以字符串形式呈現(xiàn)，到后期項(xiàng)目越來越龐大時(shí)，對于開發(fā)者而言維護(hù)工作會(huì)大大增加。當(dāng)然Gradle版本目錄我相信在后期的 Android Studio 中以默認(rèn)的形式存在。

不難看出，Android中的依賴項(xiàng)基本都是由相同部分組成，什么意思呢？即冒號(:)之前的就是所謂的依賴組，你可以理解為一個(gè)依賴組捆綁了多個(gè)相關(guān)的依賴項(xiàng)，冒號之后的就是它的組成部分。例如：

• 依賴組：androidx.compose.ui

• 間隔：冒號（:）

• 具體依賴：ui-graphics

2. 創(chuàng)建版本目錄

在 gradle 文件中添加一個(gè)名為?libs.versions.toml?文件，添加完成后，點(diǎn)擊 Sync?同步一下。

文件包含三個(gè)部分：版本塊、依賴庫塊、插件塊。

[versions]

[libraries]

[plugins]

3.?開始遷移依賴

回到 build.gradle 文件中，你會(huì)發(fā)現(xiàn)依賴項(xiàng)彈出了黃色高亮提示。

根據(jù)IDE提示可以智能的識別到版本目錄的存在，然后一鍵替換，替換后會(huì)報(bào)錯(cuò)，我們需要同步一下即可。

來到版本目錄，IDE自動(dòng)地把依賴放到了對應(yīng)的位置，如下圖：

剩余的依賴同上依次遷移過去到版本目錄即可，需要注意的是，像類似?compose-bom?已經(jīng)統(tǒng)一了版本號的物料清單，被包含的依賴不再需要定義版本號并且不需要使用?module，而是使用?group。name?代表了具體的名字。

3. 遷移插件

接下來需要處理的另一處是我們的項(xiàng)目的插件部分，當(dāng)然這部分沒有提示，需要我們手動(dòng)遷移過去。

遷移前

遷移后

在同步完成之后，如果 libs 出現(xiàn)以下報(bào)錯(cuò)問題可以參考博客解決：

博客：

https://github.com/gradle/gradle/issues/22797

源碼：

https://github.com/AAnthonyyyy/VersionCatalogsGuide