Gradle 新功能，你不能不知道_libs.versions.toml

版本帝 Gradle 最新版本已经到了 8.1.1 ，你是不是还在用着 Gradle 3 的功能？今天我们了解一下 Gradle 7.0 之后推出的新功能 Version Catalog 版本目录。

---

0. 概述

Gradle 版本目录是 Gradle7 中引入的新功能。使用 Gradle 版本目录，您可以在拥有多个模块时更轻松地管理依赖项和插件。您不必对各个 build 文件中的依赖项名称和版本进行硬编码，也不必在每次需要升级依赖项时都更新每个条目，而是可以创建一个包含依赖项的中央版本目录。

1. 创建版本目录文件

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

注意：您可以更改目录文件名；但是，这需要更改 build 文件，因此不建议这样做。

在 libs.versions.toml 文件中，添加以下内容：

[versions]
 
[libraries]
 
[bundles]
 
[plugins]

• versions部分用于声明可以被依赖项引用的版本

• libraries部分用于声明坐标的别名

• bundles部分用于声明依赖包

• plugins部分用于声明插件

2. 迁移依赖项

先看一下之前我们是如何引入依赖项的：

dependencies {
    implementation 'com.jcraft:jsch:0.1.55'
}

迁移到版本目录后的引入方式：

# libs.versions.toml 文件
[versions]
jsch = "0.1.55"
 
[libraries]
jsch = { group = "com.jcraft", name = "jsch", version.ref = "jsch" }

# build.gradle 文件
dependencies {
   implementation libs.jsch
}

3. 别名规范

从上面的简单例子中，我们可以从libs中通过别名jsch获取 jsch 的依赖项。下面介绍几种复杂的例子：

在声明依赖项的别名时建议使用 kebab-case（例如 commons-lang3），以便在 build 文件中获得更好的代码补全帮助。

4. 打包依赖项

如果有多个依赖项强关联，必须同时引用的情况，如下：

dependencies {
    implementation 'org.junit.jupiter:junit-jupiter-api:5.9.3'
    implementation 'org.junit.jupiter:junit-jupiter-engine:5.9.3'
    implementation 'org.junit.jupiter:junit-jupiter-params:5.9.3'
}

我们可以在libs.versions.toml 文件中使用bundles将其打成一个包：

[versions]
jupiter = "5.9.3"
 
[libraries]
junit-jupiter-api = { group = "org.junit.jupiter", name = "junit-jupiter-api", version.ref = "jupiter" }
junit-jupiter-engine = { group = "org.junit.jupiter", name = "junit-jupiter-engine", version.ref = "jupiter" }
junit-jupiter-params = { group = "org.junit.jupiter", name = "junit-jupiter-params", version.ref = "jupiter" }
 
[bundles]
junit-jupiter = ["junit-jupiter-api", "junit-jupiter-engine", "junit-jupiter-params"]

然后在build.gradle中引用：

dependencies {
    implementation libs.junit.jupiter
}

5. 迁移插件

迁移插件与依赖项的迁移一样，在 libs.versions.toml 文件的 [versions] 和 [plugins] 部分，为每个插件添加一个条目。然后将 build.gradle 文件中 plugins{} 代码块内的声明替换为相应的目录名称。

以下代码段展示了移除插件之前的 build.gradle 文件：

plugins {
   id("com.android.application")
}

迁移后：

[versions]
androidGradlePlugin = "7.4.1"
 
[plugins]
android-application = { id = "com.android.application", version.ref = "androidGradlePlugin" }

plugins {
   id(libs.plugins.android.application)
}

6. 小结

以上就是对 Gradle 版本目录功能的简单应用，统一管理依赖项版本，十分方便。如需了解详情，请参阅 Gradle 官方文档。

---

最后，推荐一款应用开发神器

关于目前低代码在技术领域很活跃！

低代码是什么？一组数字技术工具平台，能基于图形化拖拽、参数化配置等更为高效的方式，实现快速构建、数据编排、连接生态、中台服务等。通过少量代码或不用代码实现数字化转型中的场景应用创新。它能缓解甚至解决庞大的市场需求与传统的开发生产力引发的供需关系矛盾问题，是数字化转型过程中降本增效趋势下的产物。

这边介绍一款好用的低代码平台——JNPF快速开发平台。近年在市场表现和产品竞争力方面表现较为突出，采用的是最新主流前后分离框架（SpringBoot+Mybatis-plus+Ant-Design+Vue3）。代码生成器依赖性低，灵活的扩展能力，可灵活实现二次开发。

以JNPF为代表的企业级低代码平台为了支撑更高技术要求的应用开发，从数据库建模、Web API构建到页面设计，与传统软件开发几乎没有差异，只是通过低代码可视化模式，减少了构建“增删改查”功能的重复劳动，还没有了解过低代码的伙伴可以尝试了解一下。

应用：https://www.jnpfsoft.com/?csdn

有了它，开发人员在开发过程中就可以轻松上手，充分利用传统开发模式下积累的经验。所以低代码平台对于程序员来说，有着很大帮助。