第 5 部分:探索增量构建
版本 8.14
学习 Gradle 增量构建的基础知识。
步骤 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
标签。
下一步: 启用构建缓存 >>