11.1 Gradle on 编程那些事儿

11.1.1 Gradle

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/gradle.html

11.1.1 Gradle

Gradle 是一个构建系统，帮助你自动化和管理构建过程。它会下载所需的依赖、打包你的代码，并为编译做好准备。在 Gradle 网站上可以了解 Gradle 的基础知识和细节。

11.1.2 Gradle 与 Kotlin/JVM 入门

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/get-started-with-jvm-gradle-project.html

11.1.2 Gradle 与 Kotlin/JVM 入门

本教程演示如何使用 IntelliJ IDEA 和 Gradle 创建一个 JVM 控制台应用。

首先，下载并安装最新版本的 IntelliJ IDEA。

创建项目

在 IntelliJ IDEA 中，选择 File | New | Project。
在左侧面板中选择 Kotlin。
给新项目命名，如有必要还可以修改它的位置。

提示： 勾选 Create Git repository 复选框可以把新项目纳入版本控制。你之后再这么做也可以。

11.1.3 配置 Gradle 项目

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/gradle-configure-project.html

11.1.3 配置 Gradle 项目

要用 Gradle 构建 Kotlin 项目，你需要在构建脚本文件 build.gradle(.kts) 中添加 Kotlin Gradle 插件，并在其中配置项目依赖。

注意： 要进一步了解构建脚本的内容，请访问探索构建脚本一节。

应用插件

要应用 Kotlin Gradle 插件，请使用 Gradle 插件 DSL 中的 plugins{} 块：

11.1.4 Gradle 最佳实践

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/gradle-best-practices.html

11.1.4 Gradle 最佳实践

Gradle 是许多 Kotlin 项目用来自动化和管理构建过程的构建系统。

充分利用 Gradle 非常关键，它能帮你减少管理和等待构建的时间，把更多时间用于编码。这里我们提供一组最佳实践，分为两个关键方面：组织和优化你的项目。

11.1.5 Kotlin Gradle 插件中的编译器选项

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/gradle-compiler-options.html

11.1.5 Kotlin Gradle 插件中的编译器选项

Kotlin 的每个版本都包含面向受支持目标的编译器：JVM、JavaScript，以及面向受支持平台的本地二进制文件。

这些编译器会被以下场景使用：

11.1.6 Kotlin Gradle 插件中的编译与缓存

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/gradle-compilation-and-caches.html

11.1.6 Kotlin Gradle 插件中的编译与缓存

在本页中，你可以了解以下主题：

增量编译
Gradle 构建缓存支持
Gradle 配置缓存支持
Kotlin 守护进程以及如何在 Gradle 中使用它
回退到之前的编译器
定义 Kotlin 编译器执行策略
Kotlin 编译器回退策略
试用最新的语言版本
构建报告

增量编译

Kotlin Gradle 插件支持增量编译，它在 Kotlin/JVM 和 Kotlin/JS 项目中默认启用。增量编译会跟踪两次构建之间 classpath 中文件的变化，从而只编译受这些变化影响的文件。这种方式与 Gradle 的构建缓存配合工作，并支持跳过编译。

11.1.8 Kotlin Gradle 插件中的二进制兼容性验证

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/gradle-binary-compatibility-validation.html

11.1.8 Kotlin Gradle 插件中的二进制兼容性验证

实验性 - 通用

二进制兼容性验证帮助库作者确保用户在升级到新版本时不会破坏自己的代码。这不仅对于提供顺畅的升级体验很重要，也有助于与用户建立长期信任，并鼓励他们持续采用该库。

11.1.9 对 Gradle 插件变体的支持

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/gradle-plugin-variants.html

11.1.9 对 Gradle 插件变体的支持

Gradle 7.0 为 Gradle 插件作者引入了一项新特性——带变体的插件。该特性让插件在保持与旧版 Gradle 兼容的同时，更容易支持最新的 Gradle 特性。进一步了解 Gradle 中的变体选择。

借助 Gradle 插件变体，Kotlin 团队可以为不同的 Gradle 版本发布不同的 Kotlin Gradle 插件（KGP）变体。目标是在 main 变体中支持基础的 Kotlin 编译，它对应最早受支持的 Gradle 版本。每个变体都会包含对应版本的 Gradle 特性的实现。最新的变体支持最新的 Gradle 特性集。通过这种方式，可以在功能有限的前提下延长对较早 Gradle 版本的支持。