了解 Gradle 增量构建的基础知识。

在本部分中,您将

  • 使用 Gradle 属性

  • 了解增量构建

  • 探索任务结果标签

步骤 0. 开始之前

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

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

  3. 您已在 第 3 部分 中了解了依赖项管理。

  4. 您已在 第 4 部分 中向应用应用了插件。

步骤 1. 了解增量构建

了解 Gradle 以多种方式优化构建非常重要。其中一种优化称为增量构建

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

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

步骤 2. 更新 Gradle 属性

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

在应用的顶级文件夹 (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 标签。

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