Compose 编译器迁移指南

Compose 编译器由一个 Gradle 插件补充，该插件简化了设置并提供了更便捷的编译器选项访问。 当与 Android Gradle 插件 (AGP) 一起应用时，此 Compose 编译器插件将覆盖 AGP 自动提供的 Compose 编译器坐标。

自 Kotlin 2.0.0 起，Compose 编译器已合并到 Kotlin 版本库中。 这有助于顺利将您的项目迁移到 Kotlin 2.0.0 及更高版本，因为 Compose 编译器会与 Kotlin 同步发布，并且始终与相同版本的 Kotlin 兼容。

要在您的项目中使用新的 Compose 编译器插件，请为每个使用 Compose 的模块应用它。 关于如何迁移 Jetpack Compose 项目的详细信息，请继续阅读。对于 Compose Multiplatform 项目，请参考多平台迁移指南。

迁移 Jetpack Compose 项目

从 Kotlin 1.9 迁移到 2.0.0 或更高版本时，您应该根据处理 Compose 编译器的方式调整项目配置。我们建议使用 Kotlin Gradle 插件和 Compose 编译器 Gradle 插件来自动化配置管理。

使用 Gradle 插件管理 Compose 编译器

对于 Android 模块：

1. 将 Compose 编译器 Gradle 插件添加到 Gradle 版本目录：

[versions]
# ...
kotlin = "2.2.10"

[plugins]
# ...
org-jetbrains-kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
compose-compiler = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }

2. 将 Gradle 插件添加到根 build.gradle.kts 文件：

plugins {
    // ...
    alias(libs.plugins.compose.compiler) apply false
}

3. 将插件应用于每个使用 Jetpack Compose 的模块：

plugins {
    // ...
    alias(libs.plugins.compose.compiler)
}

4. 如果您正在使用 Jetpack Compose 编译器的编译器选项，请在 composeCompiler {} 代码块中设置它们。 请参见编译器选项列表。

5. 如果您直接引用 Compose 编译器构件，可以移除这些引用，让 Gradle 插件来处理。

不使用 Gradle 插件管理 Compose 编译器

如果您不使用 Gradle 插件来管理 Compose 编译器，请更新项目中对旧 Maven 构件的任何直接引用：

• 将 androidx.compose.compiler:compiler 更改为 org.jetbrains.kotlin:kotlin-compose-compiler-plugin-embeddable
• 将 androidx.compose.compiler:compiler-hosted 更改为 org.jetbrains.kotlin:kotlin-compose-compiler-plugin

后续步骤

• 关于 Compose 编译器迁移到 Kotlin 版本库，请参见 Google 的公告。
• 如果您正在使用 Jetpack Compose 构建 Android 应用，请查阅关于如何使其支持多平台的指南。