更新 Compose 编译器
Compose 编译器通过 Gradle 插件进行增强,该插件简化了配置流程并提供了更便捷的编译器选项访问方式。当与 Android Gradle 插件 (AGP) 共同应用时,此 Compose 编译器插件将覆盖 AGP 自动提供的 Compose 编译器坐标。
自 Kotlin 2.0.0 起,Compose 编译器已合并至 Kotlin 代码库。这一变化有助于项目平滑迁移至 Kotlin 2.0.0 及更高版本,因为 Compose 编译器将与 Kotlin 同步发布,并始终保证与同版本 Kotlin 的兼容性。
要在项目中使用新版 Compose 编译器插件,需为每个使用 Compose 的模块应用该插件。下文将详细介绍如何迁移 Compose Multiplatform 项目 。若需迁移 Jetpack Compose 项目,请参阅迁移指南。
迁移 Compose Multiplatform 项目
从 Compose Multiplatform 1.6.10 开始,应为每个使用 org.jetbrains.compose
插件的模块应用 org.jetbrains.kotlin.plugin.compose
Gradle 插件:
将 Compose 编译器 Gradle 插件添加至 Gradle 版本目录:
在根目录
build.gradle.kts
文件中添加 Gradle 插件:
为每个使用 Compose Multiplatform 的模块应用插件:
若需配置 Jetpack Compose 编译器选项,请在
composeCompiler {}
代码块中设置。参考 Compose 编译器选项 DSL。
可能问题:"Missing resource with path"
从 Kotlin 1.9.0 切换至 2.0.0,或从 2.0.0 回退至 1.9.0 时,可能遇到以下错误:
解决方法:删除项目根目录及所有模块中的 build
目录。
后续步骤
查看 Google 关于 Compose 编译器迁移至 Kotlin 代码库的公告。
迁移 Jetpack Compose 应用时,请查阅 Compose 编译器文档。