Gradle 5.0 正式版本发布,一大波新特性来袭

简介: > **官方 5.0 Release Note 链接**:https://docs.gradle.org/5.0/release-notes.html ### 前言 在历经了一年多时间, 20 个 4.x 系列版本的迭代后,Gradle 官方终于在 11月26日 发布了 5.0 的正式版本,让我们赶紧来看一下有哪些令人激动的新特性。 #### 官方新特性一览 - Kotli

官方 5.0 Release Note 链接https://docs.gradle.org/5.0/release-notes.html

前言

在历经了一年多时间, 20 个 4.x 系列版本的迭代后,Gradle 官方终于在 11月26日 发布了 5.0 的正式版本,让我们赶紧来看一下有哪些令人激动的新特性。

官方新特性一览

  • Kotlin DSL 1.0
  • Dependency version alignment
  • Gradle build initialization features
  • Searchable documentation
  • Task timeouts
  • HTTP retries during dependency resolution
  • Java 11 runtime support
  • Plugin authoring features
  • Gradle Native features
  • Promoted features

Kotlin DSL 1.0

早在 Gradle 4.x 版本中就已经支持了通过使用 Koltin DSL 的方式去编写构建脚本,但是当时刚出来,很多地方支持的还不太好(需要踩坑),所以并不推荐大家迁移过去,而是尝鲜为主。现在 Kotlin DSL 1.0 release 版本出来后,意味着接下来你可以放心的迁移或者使用 Kotlin DSL 啦。新版本做了很多优化和改进的地方,比如:

  • Code Completion:代码自动完成
  • Error Highlighting:错误高亮
  • Quick Documentation:文档快速提示
  • Refactoring:代码重构

    ![图片来自官方](https://user-gold-cdn.xitu.io/2018/11/27/16753ed585f2bd3f?w=1340&h=746&f=png&s=649481)
    

如何迁移你的构建语言到 Kotlin DSL 上,可以参考我的另一篇文章[Gradle指南之从Groovy迁移到Kotlin

](https://juejin.im/post/5b875c9c6fb9a01a0d74c34b)

Dependency version alignment

Dependency version alignment allows different modules belonging to the same logical group (a platform) to have identical versions in a dependency graph.

根据官网的介绍,直译过来的意思是:依赖版本一致性允许属于相同的逻辑组(平台)的不同module 拥有相同的版本依赖图。

这个概念确实不好理解,我自己也是花了一些时间去理解和消化。还是通过一个示例来说明吧。如果有英文水平高或者理解能力比较强的同学,欢迎指教。

比如,我们 build.gradle 有以下依赖:

    dependencies {
        // a dependency on Jackson Databind
        implementation 'com.fasterxml.jackson.core:jackson-databind:2.8.9'

        // and a dependency on vert.x
        implementation 'io.vertx:vertx-core:3.5.3'
    }

因为 vertx-core 也间接依赖了 jackson-core,通过依赖传递,当解析依赖信息的时候,我们实际依赖的版本号是:

  • jackson-core 版本 2.9.5(依赖传递)
  • jackson-databind 版本 2.8.9 -> 2.9.5(低版本通过依赖仲裁变为高版本)
  • jackson-annotation 版本 2.9.0 (jackson-databind 2.8.9 版本间接依赖 jackson-annotation 2.9.0 版本,注意这里,因为上面的依赖仲裁,变成了被高版本 的 jackson-databind 2.9.5 所依赖)

通过以上的分析,我们发现实际上解析出来的依赖库版本出现了和预期不一致的情况,而类似这种情况很容易会导致一些未知问题,尤其是在一些不兼容老版本接口的依赖库里就会直接导致 Crash。

通常,针对这种问题,之前的做法可能就是简单粗暴的强指定版本号,不过,现在有了更加优雅的方式去帮助我们去管理版本,即 Dependency version alignment,我们可以通过指定一个 platform 去管理某一组的 module

回到刚才的场景示例中,我们在 build.gradle 里可以定义 jackson 为一组的 module 版本的规则,如下所示:

    class JacksonAlignmentRule implements ComponentMetadataRule {
        void execute(ComponentMetadataContext ctx) {
            ctx.details.with {
                if (id.group.startsWith("com.fasterxml.jackson")) {
                    // declare that Jackson modules all belong to the Jackson virtual platform
                    belongsTo("com.fasterxml.jackson:jackson-platform:${id.version}")
                }
            }
        }
    }

然后应用该规则:

    dependencies {
        components.all(JacksonAlignmentRule)
    }

最后,在执行完 ./gradlew app:dependencies 命令后,你会发现当匹配上 com.fasterxml.jackson 组的 module 的版本都保持了一致,也就是

  • jackson-core 版本 2.9.5
  • jackson-databind 版本 2.8.9 -> 2.9.5
  • jackson-annotation 版本 2.9.0 -> 2.9.5

另外,platform 同样也提供了强制为一组 module 指定某个版本号,比如:

    dependencies {
        // Forcefully downgrade the Jackson platform to 2.8.9
        implementation enforcedPlatform('com.fasterxml.jackson:jackson-platform:2.8.9')
    }

还有一个比较方便的地方,就是通过 platform,我们可以直接省略该 module 的版本号(从此告别通过定义版本变量去维护众多 module 的版本信息),如下所示:

    dependencies {
        // import a BOM. The versions used in this file will override any other version found in the graph
        implementation(enforcedPlatform("org.springframework.boot:spring-boot-dependencies:1.5.8.RELEASE"))

         // define dependencies without versions
        implementation("com.google.code.gson:gson")
        implementation("dom4j:dom4j")

         // this version will be overriden by the one found in the BOM
        implementation("org.codehaus.groovy:groovy:1.8.6")
    }

Gradle build initialization features

新版本对 gradle init 方法进行了升级,通过更多的特性和交互,来帮助我们去快速初始化一个 Gradle 项目。简单来说的话,就是加强版的脚手架。

Interactive mode

当你在控制台执行 init task 后,Gradle 将会提供更多的构建信息提示,来帮助你生成 Gradle 模版项目。

Kotlin library and applications

init task 可以通过 kotlin-library 或者 kotlin-application 类型来设置生成一个 Kotlin 的类库或者应用。你只需要根据它的提示来操作即可。

Generated builds use recommended configurations

init task 生成的构建脚本将推荐使用新的 implementationtestImplementationtestRuntimeOnly 去代替 compiletestCompiletestRuntime

Configure project and source package names

  • --project-name 选项可以帮助你调整生成的项目名称
  • --package 选项可以帮助你调整生成的项目包名

Create resource directories

init task 会创建一个空的 resource 目录

Create a .gitignore file

init task 会生成一个简单的 .gitignore 文件来帮助你设置你的 Git repository 。

Searchable documentation

Gradle 的文档搜索功能回来了(虽然我一直不知道这个功能在哪里),总之,可以更加方便的搜索用户手册和 DSL 的描述。

当然,还有更方便查找类和方法的 Gradle API Javadocs

Task timeouts

这个超时设置简直太有用了有木有。特别是当你因为一些网络原因,导致你的 build task 一直卡在那里的时候,你的心里一定是万马奔腾的感觉,赶紧用起来吧,不要再浪费这些无用的时间了。示例:

    task hangingTask() {
        doLast {
            Thread.sleep(100000)
        }
        timeout = Duration.ofMillis(500)
    }

HTTP retries during dependency resolution

HTTP 访问重试功能,嗯。挺好

Performance features

Gradle can be started as a low-priority process

通过 --priority low 命令参数或者 org.gradle.priority=low 属性设置可以让你的 Gradle 以一个低优先级的进程启动,至于好处嘛,当然是你一边在 building 的时候,一边听音乐的时候,再也不会感觉一卡一卡的了 :)

JaCoCo plugin now works with the build cache and parallel test execution

简单看了下介绍,可以帮助你查看代码覆盖率的 JaCoCo 插件,感兴趣的同学可以点这里了解更多

Java 11 runtime support

Gradle 5.0 版本构建支持 Java 11 版本

Plugin authoring features

这个版本为插件和自定义 task 提供了创建 SourceDirectorySet 的 API、提高 Provider 的 API、和构建缓存的兼容性提高。

Gradle Native features

Gradle Native project 持续的改善和提升 native 生态系统,
更多细节:Changes included in Gradle 5.0

Promoted features

一些现有功能的提升,详细点击这里

其他

5.0 版本共计修复了 166 个 issues(惊人),当然,伴随而来的还有一些已知的 issues ,详细可以点击这里 5.0 release-notes

总结

Gradle 5.0 版本真的是干货满满,尤其是对于使用 Gradle 构建的 Android 或者 Java 开发者来说,像 Kotlin DSL(构建语言)、Dependency version alignment(依赖版本一致性)、Performance features(性能提升) 等等这些特性还是很让人期待的。有兴趣的小伙伴可以赶紧更新一波了。

如何升级到 Gradle 5.0 版本呢,很简单,以下两种方式任选其一

  • 执行 ./gradlew wrapper --gradle-version=5.0 命令
  • 或者直接修改你的 rootProject/gradle/wrapper/gradle-wrapper.properties

        distributionBase=GRADLE_USER_HOME
        distributionPath=wrapper/dists
        distributionUrl=https\://services.gradle.org/distributions/gradle-5.0-all.zip
        zipStoreBase=GRADLE_USER_HOME
        zipStorePath=wrapper/dists
目录
相关文章
|
人工智能 移动开发 Java
Android Studio插件版本与Gradle 版本对应关系
Android Studio插件版本与Gradle 版本对应关系
2353 0
Android Studio插件版本与Gradle 版本对应关系
|
Java 开发工具 Android开发
Cocos Creator 2.4.6 Android Gradle 版本升级为 6.5.1(插件4.1.0)
Cocos Creator 2.4.6 Android Gradle 版本升级为 6.5.1(插件4.1.0)
316 1
|
26天前
|
Java Spring
Gradle 如何确保依赖的版本兼容性
Gradle 通过依赖管理机制确保版本兼容性,使用声明式配置定义项目依赖,自动解析和下载所需库。它支持版本范围和动态版本,通过冲突解决策略选择最佳版本,保证构建的一致性和可靠性。
|
3月前
|
IDE API 开发工具
与Android Gradle Plugin对应的Gradle版本和Android Studio版本
与Android Gradle Plugin对应的Gradle版本和Android Studio版本
416 0
|
Cloud Native Java Go
解决 Spring Boot 和 Gradle Java 版本兼容性问题:A problem occurred configuring root project ‘demo1‘. > Could n
解决 Spring Boot 和 Gradle Java 版本兼容性问题:A problem occurred configuring root project ‘demo1‘. > Could n
938 0
|
6月前
|
缓存 Java API
build.gradle文件介绍,gradle版本对应
build.gradle文件介绍,gradle版本对应
168 0
|
6月前
|
Java 测试技术 API
云效流水线构建gradle项目失败提示gradle版本过低如何解决
云效(CloudEfficiency)是阿里云提供的一套软件研发效能平台,旨在通过工程效能、项目管理、质量保障等工具与服务,帮助企业提高软件研发的效率和质量。本合集是云效使用中可能遇到的一些常见问题及其答案的汇总。
326 0
|
11月前
EMAS平台不支持Gradle 8.0以上版本
EMAS平台不支持Gradle 8.0以上版本
88 7
|
缓存 Java API
Gradle 构建工具 #5 又冲突了!如何理解依赖冲突与版本决议?
Gradle 作为官方主推的构建系统,目前已经深度应用于 Android 的多个技术体系中,例如组件化开发、产物构建、单元测试等。可见,要成为 Android 高级工程师 Gradle 是必须掌握的知识点。
222 0
Gradle 构建工具 #5 又冲突了!如何理解依赖冲突与版本决议?
gradle中统一配置版本的小技巧。
gradle中统一配置版本的小技巧。