更新 Compose 编译器

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

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

强烈建议您将使用 Kotlin 2.0.0 创建的 Compose Multiplatform 应用更新到 2.0.10 或更高版本。Compose 编译器 2.0.0 存在一个问题，即在具有非 JVM 目标的多平台项目中，它有时会错误地推断类型的稳定性，这可能导致不必要的（甚至无止境的）重组。

如果您的应用是使用 Compose 编译器 2.0.10 或更高版本构建的，但使用的依赖项是使用 Compose 编译器 2.0.0 构建的，那么这些旧的依赖项仍可能导致重组问题。 为了防止这种情况，请将您的依赖项更新到与您的应用使用相同 Compose 编译器构建的版本。

要在您的项目中使用新的 Compose 编译器插件，请将其应用于每个使用 Compose 的模块。 阅读下文以了解有关如何迁移 Compose Multiplatform 项目的详细信息。对于 Jetpack Compose 项目，请参阅迁移指南。

迁移 Compose Multiplatform 项目

从 Compose Multiplatform 1.6.10 开始，您应该将 org.jetbrains.kotlin.plugin.compose Gradle 插件应用于每个使用 org.jetbrains.compose 插件的模块：

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

   [versions]
   # ...
   kotlin = "2.3.0"
   compose-plugin = "1.9.3"
   
   [plugins]
   # ...
   jetbrainsCompose = { id = "org.jetbrains.compose", version.ref = "compose-plugin" }
   kotlinMultiplatform = { id = "org.jetbrains.kotlin.multiplatform", version.ref = "kotlin" }
   compose-compiler = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }

2. 将 Gradle 插件添加到根目录的 build.gradle.kts 文件中：

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

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

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

4. 如果您正在为 Jetpack Compose 编译器使用编译器选项，请在 composeCompiler {} 代码块中进行设置。 请参阅 Compose 编译器选项 DSL 以供参考。

可能出现的问题：“Missing resource with path”

从 Kotlin 1.9.0 切换到 2.0.0，或从 2.0.0 切换到 1.9.0 时，您可能会遇到以下错误：

org.jetbrains.compose.resources.MissingResourceException: Missing resource with path: ...

要解决此问题，请删除所有 build 目录：包括项目根目录中以及每个模块中的目录。

后续步骤

• 查看 Google 关于 Compose 编译器移至 Kotlin 仓库的公告。
• 请参阅 Compose 编译器选项 DSL 以供参考。
• 要迁移 Jetpack Compose 应用，请查看 Compose 编译器文档。