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 模块：
- 将 Compose 编译器 Gradle 插件添加到 Gradle 版本目录：
[versions]
# ...
kotlin = "2.1.20"
[plugins]
# ...
org-jetbrains-kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
compose-compiler = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }
- 将 Gradle 插件添加到根
build.gradle.kts文件：
plugins {
// ...
alias(libs.plugins.compose.compiler) apply false
}
- 将插件应用于每个使用 Jetpack Compose 的模块：
plugins {
// ...
alias(libs.plugins.compose.compiler)
}
-
如果你正在使用 Jetpack Compose 编译器的编译器选项，请在
composeCompiler {}块中设置它们。 有关参考，请参阅编译器选项列表。 -
如果你直接引用 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
接下来做什么
- 请参阅 Google 的公告，了解有关 Compose 编译器迁移到 Kotlin 仓库的信息。
- 如果你正在使用 Jetpack Compose 构建 Android 应用程序，请查看我们关于如何使其成为多平台的指南。