在Kotlin中使用Gradle构建缓存

你可以从这次构建观测中看到，Kotlin编译任务从构建缓存中拉取缓存结果；而:jar和:processResources任务没有从缓存中拉取，因为它们本地生成JAR包和复制文件的速度比从缓存中拉取缓存结果的速度更快。另外Gradle构建缓存也支持缓存:test任务。

当持续集成的一个实例填充了一个共享的构建缓存（开发者可以从中拉取）时，Gradle构建缓存会特别有效。下文罗列了实现这点的更多资源的链接。

为你的项目启用构建缓存

我希望你会在自己的项目上尝试使用构建缓存——你可以遵循下面的步骤来启用构建缓存。

首先，你需要确保正在使用Gradle 4.3或者更高版本，这样才能选择Kotlin Gradle Plugin来使用新的Gradle APIs。你可以方便地使用Gradle wrapper升级Gradle。

然后，你需要确保正在使用Kotlin 1.2.20或更高版本来进行编译。你在自己的构建脚本build.gradle中的buildscript {}块中配置类似如下的声明：

dependencies {
    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.2.21"
}

然后，我们需要让Gradle使用构建缓存。有3种启用构建缓存的方法：

• 在命令行中使用--build-cache来为当前构建启用构建缓存。
• 在$PROJECT_ROOT/gradle.properties中增加org.gradle.caching=true来为整个项目启用构建缓存。
• 在$GRADLE_HOME/gradle.properties中增加org.gradle.caching=true来为当前用户的所有构建启用构建缓存。

注意: Android开发者即使设置了android.enableBuildCache=true，也仍需要按照上述方法启用构建缓存，因为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任务

目前即使使用--build-cache，针对kapt的缓存也默认是禁用的，因为Gradle还没有一种方法来映射注解处理器的输入和输出。你可以通过在kapt配置中将useBuildCache设置为true来明确启用针对Kotlin注解处理任务的构建缓存。

 kapt {
useBuildCache = true
}

推荐读物

你可以通过下列资源来了解更多关于利用Gradle构建缓存的信息：

• Configuring the build cache
• Setting up a shared, remote build cache ⚡️
• Debugging build cache misses
• Developing cacheable custom tasks

结论

使用kotlin-gradle-plugin 1.2.20及以上版本编译Kotlin代码，可以利用Gradle的--build-cache功能来加快开发周期。我们正在继续努力来扩展支持构建缓存的任务集。

关于作者

Eric Wendelin是Gradle的软件工程师，旨在让软件构建更简单。

查看英文原文：Using Gradle build cache with Kotlin

本文永久更新链接地址：https://www.bkjia.com/Linux/2018-03/151329.htm