构建工具 API
Kotlin 拥有构建工具 API (BTA),它简化了构建系统与 Kotlin 编译器的集成方式。
要在构建系统中添加完整的 Kotlin 支持(例如增量编译、Kotlin 编译器插件、守护进程以及 Kotlin 多平台),需要付出巨大的努力。BTA 旨在通过在构建系统与 Kotlin 编译器生态系统之间提供统一的 API 来降低这种复杂性。
BTA 定义了一个构建系统可以实现的单一入口点。这消除了与编译器内部细节深度集成的需求。
不同目标的稳定性级别有所不同:BTA 针对 Kotlin/JVM 处于 Beta 阶段,针对 Kotlin/JS 和 Kotlin/Wasm 处于 Alpha 阶段。有关详细信息,请参阅 Build tools API (BTA)。使用 BTA 需要通过 @OptIn(ExperimentalBuildToolsApi::class) 选择启用。
与 Gradle 集成
Kotlin Gradle 插件 (KGP) 默认使用 BTA 进行 Kotlin/JVM 编译。
我们非常感谢您在 YouTrack 中反馈您使用 KGP 的体验。
为 Kotlin/JS、Kotlin/Wasm 和 Kotlin 元数据启用 BTA
自 Kotlin 2.4.20 起,KGP 还可以通过 BTA 运行 Kotlin/JS、Kotlin/Wasm 以及 Kotlin 元数据编译。这使得 KGP 与编译器的交互更加一致,并且在某些情况下编译变得更快、更稳定。
在 Kotlin 2.4.20 中,这些目标需要选择启用。要试用它们,请在您的 gradle.properties 文件中添加相应的属性:
kotlin.js.runViaBuildToolsApi = true
kotlin.wasm.runViaBuildToolsApi = true
kotlin.metadata.runViaBuildToolsApi = true配置不同的编译器版本
借助 BTA,您现在可以使用与 KGP 所用版本不同的 Kotlin 编译器版本。这在以下情况下非常有用:
- 您想尝试新的 Kotlin 功能,但尚未更新您的构建脚本。
- 您需要最新的插件修复,但目前想保留在旧的编译器版本上。
以下是在 build.gradle.kts 文件中配置此项的示例:
import org.jetbrains.kotlin.buildtools.api.ExperimentalBuildToolsApi
import org.jetbrains.kotlin.gradle.ExperimentalKotlinGradlePluginApi
plugins {
kotlin("jvm") version "2.4.20"
}
group = "org.jetbrains.example"
version = "1.0-SNAPSHOT"
repositories {
mavenCentral()
}
kotlin {
jvmToolchain(8)
@OptIn(ExperimentalBuildToolsApi::class, ExperimentalKotlinGradlePluginApi::class)
compilerVersion.set("2.3.21") // <-- 与 2.4.20 不同的版本
}兼容的 Kotlin 编译器与 KGP 版本
BTA 支持:
- 之前的三个主要 Kotlin 编译器版本。
- 向前一个主要版本。
例如,在 KGP 2.2.0 中,支持的 Kotlin 编译器版本为:
- 1.9.25
- 2.0.x
- 2.1.x
- 2.2.x
- 2.3.x
局限性
将不同的编译器版本与编译器插件一起使用可能会导致 Kotlin 编译器异常。Kotlin 团队计划在未来的 Kotlin 版本中解决此问题。
启用使用 "in process" 策略的增量编译
KGP 支持三种 编译器执行策略。 通常情况下,"in-process" 策略(在 Gradle 守护进程中运行编译器)不支持增量编译。
借助 BTA,"in-process" 策略现在支持增量编译。要启用它,请在您的 gradle.properties 文件中添加以下属性:
kotlin.compiler.execution.strategy=in-process与 Maven 集成
BTA 使 kotlin-maven-plugin 能够支持 Kotlin 守护进程,这是默认的 编译器执行策略。kotlin-maven-plugin 默认使用 BTA,因此无需进行任何配置。
BTA 使得在未来交付更多功能(如 增量编译稳定性)成为可能。
