作者|Eric Wendelin
译者|张健欣
Kotlin 1.2.21 允许 Kotlin 项目使用构建缓存,通过 Gradle 的构建缓存功能,可以提升 Kotlin 代码的编译速度,加快开发周期。本文将结合实际例子,介绍利用 Gradle 加速 Kotlin 代码编译的原理、配置示例以及在 IDE 中的使用方法。
构建缓存允许 Gradle 可以复用任何之前调用(包括那些来自其它机器的调用)的任务产出。Kotlin 1.2.21 允许 Kotlin 项目使用构建缓存。
构建缓存的工作原理是在缓存中存储编译过的类、测试结果和其它构建工序,同时记录所有的任务输入,包括输入文件内容、相关的类路径和任务配置。
这常常导致更快的构建。下面的图标展示了在 Gradle 的持续集成中使用构建缓存和不使用构建缓存所收集到的构建时间:
本文中,我们将向你阐述,如何使用 Gradle 的构建缓存来避免不必要的 Kotlin 编译,从而加快你的构建过程。
Spek 快速示例
你现在就可以尝试使用 Gradle 的构建缓存。只需要遵循下面几个步骤:
Clone Spek
Spek 分支(其默认分支)已经有我们后续要介绍的 构建缓存的所有先决条件。
构建和填充缓存
下面的命令会构建 Spek 并填充本地构建缓存。
使用标识,可以让 Gradle 在一个独立的任务结果缓存中存储任务结果。
删除 / 更改构建结果
这模拟了在另一台机器上的情况或者做了一次改变并(存储)这次改变的情况。演示的最快方法是使用任务。
从构建缓存中重新构建
当我们重新构建时,从构建缓存中拉取所有编译过的 Kotlin 源码。
就是这样!通过使用 Gradle 的构建缓存,你重用了编译过的 Kotlin 类,而不是又重新编译!构建速度差不多快了 5 倍!
你可以从 这次构建观测 中看到,Kotlin 编译任务从构建缓存中拉取缓存结果;而和任务没有从缓存中拉取,因为它们本地生成 JAR 包和复制文件的速度比从缓存中拉取缓存结果的速度更快。另外 Gradle 构建缓存也支持缓存任务。
当持续集成的一个实例填充了一个 共享的构建缓存(开发者可以从中拉取)时,Gradle 构建缓存会特别有效。下文罗列了实现这点的 更多资源的链接。
为你的项目启用构建缓存
我希望你会在自己的项目上尝试使用构建缓存——你可以遵循下面的步骤来启用构建缓存。
首先,你需要确保正在使用 Gradle 4.3 或者更高版本,这样才能选择 Kotlin Gradle Plugin 来使用新的 Gradle APIs。你可以方便地使用 Gradle wrapper 升级 Gradle。
然后,你需要确保正在使用 Kotlin 1.2.20 或更高版本来进行编译。你在自己的构建脚本中的块中配置类似如下的声明:
然后,我们需要让 Gradle 使用构建缓存。有 3 种启用构建缓存的方法:
在命令行中使用来为当前构建启用构建缓存。
在中增加来为整个项目启用构建缓存。
在中增加来为当前用户的所有构建启用构建缓存。
注意:Android 开发者即使设置了,也仍需要按照上述方法启用构建缓存,因为 Gradle 的构建缓存是独立于 Android 的构建缓存的。
我们可以选择通过将 run 和 test actions 委派给 Gradle 的方式,来利用 IDE 的构建缓存。
在 IntelliJ 中启用构建缓存
如果你使用 IntelliJ 来执行 Gradle actions,你需要在 IDE 配置中勾选“Delegate IDE build/run actions to Gradle(将 IDE 构建 / 运行动作委派给 Gradle)”,从而在 IntelliJ 中构建和运行测试时利用构建缓存。
注意:Android Studio 默认这样做。
缓存 kapt 任务
目前即使使用,针对的缓存也默认是禁用的,因为 Gradle 还没有一种方法来映射注解处理器的输入和输出。你可以通过在配置中将设置为来明确启用针对 Kotlin 注解处理任务的构建缓存。
推荐读物
领取专属 10元无门槛券
私享最新 技术干货