学习 Gradle 增量构建的基础知识。

在本节中,你将

  • 使用 Gradle properties

  • 理解增量构建

  • 探索任务结果标签

步骤 0. 开始之前

  1. 你在第 1 部分中初始化了 Java 应用。

  2. 你在第 2 部分中运行了多个任务。

  3. 你在第 3 部分中学习了依赖管理。

  4. 你在第 4 部分中为你的应用应用了插件。

步骤 1. 理解增量构建

重要的是要知道 Gradle 以多种方式优化你的构建。其中一种优化称为增量构建

增量构建是一种构建,它避免运行自上次构建以来输入未更改的任务,从而使得执行此类任务不是必需的。

为了使增量构建正常工作,任务必须定义其输入和输出。在构建时,Gradle 将确定输入或输出是否已更改。如果已更改,Gradle 将执行该任务。否则,它将跳过执行。

步骤 2. 更新 Gradle Properties

为了更好地了解增量构建的实际效果,我们将控制台输出切换到详细模式。

在你的应用顶层文件夹 (tutorial) 中,创建一个 gradle.properties 文件

$ touch gradle.properties

添加 org.gradle.console=verbose,使文件内容如下所示

gradle.properties
org.gradle.console=verbose

步骤 3. 分析增量构建

使用 ./gradlew :app:clean :app:build 命令运行 clean 任务,然后运行 build 任务

$ ./gradlew :app:clean :app:build

> Task :app:clean
> Task :app:compileJava
> Task :app:processResources NO-SOURCE
> Task :app:classes
> Task :app:jar
> Task :app:startScripts
> Task :app:distTar
> Task :app:distZip
> Task :app:assemble
> Task :app:compileTestJava
> Task :app:processTestResources NO-SOURCE
> Task :app:testClasses
> Task :app:test
> Task :app:check
> Task :app:build

BUILD SUCCESSFUL in 1s
8 actionable tasks: 8 executed

毫不意外,Gradle 调用了构建应用所需的所有任务。这已成功完成。

再次运行构建以查看增量构建优化的实际效果

$ ./gradlew :app:build

> Task :app:compileJava UP-TO-DATE
> Task :app:processResources NO-SOURCE
> Task :app:classes UP-TO-DATE
> Task :app:jar UP-TO-DATE
> Task :app:startScripts UP-TO-DATE
> Task :app:distTar UP-TO-DATE
> Task :app:distZip UP-TO-DATE
> Task :app:assemble UP-TO-DATE
> Task :app:compileTestJava UP-TO-DATE
> Task :app:processTestResources NO-SOURCE
> Task :app:testClasses UP-TO-DATE
> Task :app:test UP-TO-DATE
> Task :app:check UP-TO-DATE
> Task :app:build UP-TO-DATE

BUILD SUCCESSFUL in 409ms
7 actionable tasks: 7 up-to-date

大多数任务现在都有 UP-TO-DATE 标签。Gradle 通过这种方式告知我们输入和输出没有改变,因此某些任务没有重新运行。

步骤 4. 理解结果标签

在详细模式开启时,开发者可以使用以下四种标签来查看任务结果

结果标签 描述

UP-TO-DATE

已执行且未更改的任务(增量构建特性)

SKIPPED

任务被明确阻止运行

FROM-CACHE

任务输出已从构建缓存中的先前构建复制到本地目录(缓存特性)

NO-SOURCE

任务未执行,因为其必需的输入不可用

如果没有标签,则任务由 Gradle 新近执行(本地)。

我们将在下一节中查看 FROM-CACHE 标签。

下一步: 启用构建缓存 >>