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 项目

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

使用 Gradle 插件管理 Compose 编译器

对于 Android 模块：

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

   [versions]
   # ...
   kotlin = "2.1.21"
   
   [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 应用，请查看 我们关于如何将其变为多平台的指南。