使用 Gradle 版本目录进行依赖管理 - Android

/ 前言 /

在软件开发中,依赖管理是一个至关重要的方面。合理的依赖版本控制有助于确保项目的稳定性、安全性和可维护性。

Gradle版本目录(Version Catalogs)是 Gradle 构建工具的一个强大功能,它为项目提供了一种集中管理依赖版本的方式,使得团队协作更为高效。

/ 什么是版本目录?/

Gradle版本目录是 Gradle 6.8 版本引入的一项新功能,它允许开发者将项目中使用的所有第三方依赖的版本信息集中管理在一个地方。

通过定义一个版本目录,你可以在一个文件中指定所有依赖的版本号,而不必在每个模块或构建文件中重复声明。

/示例/

1. 新建一个空项目

首先创建一个空白的 Android 项目,默认情况下我们的 Gradle 文件如下:

可以看到所有的依赖都是以字符串形式呈现,到后期项目越来越庞大时,对于开发者而言维护工作会大大增加。当然Gradle版本目录我相信在后期的 Android Studio 中以默认的形式存在。

不难看出,Android中的依赖项基本都是由相同部分组成,什么意思呢?即冒号(:)之前的就是所谓的依赖组,你可以理解为一个依赖组捆绑了多个相关的依赖项,冒号之后的就是它的组成部分。例如:

  • 依赖组:androidx.compose.ui

  • 间隔:冒号(:)

  • 具体依赖:ui-graphics

2. 创建版本目录

在 gradle 文件中添加一个名为 libs.versions.toml 文件,添加完成后,点击 Sync 同步一下。

文件包含三个部分:版本块、依赖库块、插件块。

复制代码

[versions]

[libraries]

[plugins]

3. 开始迁移依赖

回到 build.gradle 文件中,你会发现依赖项弹出了黄色高亮提示。

根据IDE提示可以智能的识别到版本目录的存在,然后一键替换,替换后会报错,我们需要同步一下即可。

来到版本目录,IDE自动地把依赖放到了对应的位置,如下图:

剩余的依赖同上依次迁移过去到版本目录即可,需要注意的是,像类似 compose-bom 已经统一了版本号的物料清单,被包含的依赖不再需要定义版本号并且不需要使用 module,而是使用 group。name 代表了具体的名字。

3. 迁移插件

接下来需要处理的另一处是我们的项目的插件部分,当然这部分没有提示,需要我们手动迁移过去。

迁移前

迁移后

在同步完成之后,如果 libs 出现以下报错问题可以参考博客解决:

博客:

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

源码:

https://github.com/AAnthonyyyy/VersionCatalogsGuide

相关推荐
闲暇部落27 分钟前
‌Kotlin中的?.和!!主要区别
android·开发语言·kotlin
诸神黄昏EX2 小时前
Android 分区相关介绍
android
大白要努力!3 小时前
android 使用SQLiteOpenHelper 如何优化数据库的性能
android·数据库·oracle
Estar.Lee4 小时前
时间操作[取当前北京时间]免费API接口教程
android·网络·后端·网络协议·tcp/ip
Winston Wood4 小时前
Perfetto学习大全
android·性能优化·perfetto
Dnelic-7 小时前
【单元测试】【Android】JUnit 4 和 JUnit 5 的差异记录
android·junit·单元测试·android studio·自学笔记
Eastsea.Chen9 小时前
MTK Android12 user版本MtkLogger
android·framework
长亭外的少年16 小时前
Kotlin 编译失败问题及解决方案:从守护进程到 Gradle 配置
android·开发语言·kotlin
建群新人小猿19 小时前
会员等级经验问题
android·开发语言·前端·javascript·php
1024小神20 小时前
tauri2.0版本开发苹果ios和安卓android应用,环境搭建和最后编译为apk
android·ios·tauri