Compose Multiplatform 1.6.10 版本中 Wasm 资源加载问题解析

在 Kotlin Multiplatform 开发中，Compose Multiplatform 是一个强大的跨平台 UI 框架。最近升级到 1.6.10 版本后，开发者遇到了 Wasm 平台资源加载失败的问题，错误提示为"MissingResourceException: Missing resource with path: ./values/strings.commonMain.cvr"。

问题背景

当开发者将项目从旧版本升级到 Compose Multiplatform 1.6.10 时，发现原本可用的资源加载机制在 WebAssembly (Wasm) 平台上不再工作。这个问题特别出现在多模块项目中，其中资源定义在一个共享模块中，而 Wasm 应用模块需要访问这些资源。

技术分析

在 Compose Multiplatform 中，资源处理有以下关键点：

1. 资源打包机制：Compose 会将资源文件编译为 .cvr 格式的二进制资源包
2. 多模块支持：从 Kotlin Gradle Plugin 2.0.0-Beta5 开始才完全支持多模块项目的资源处理
3. Wasm 平台特殊性：Wasm 平台需要额外的资源处理步骤，因为其运行环境与 JVM/Android 不同

解决方案

对于仍在使用 Kotlin 1.9.23 和 Compose 1.6.10 的项目，可以采用以下临时解决方案：

1. 手动资源复制：通过 Gradle 任务将生成的资源文件复制到 Wasm 构建目录
2. 资源生成目录：资源文件会被生成在 build/generated/processedResources 目录中
3. 任务依赖调整：确保资源复制任务在 wasmJsProcessResources 任务之后执行

最佳实践建议

虽然临时解决方案可以解决问题，但长期来看建议：

1. 升级到 Kotlin Gradle Plugin 2.0.0 或更高版本以获得完整的资源处理支持
2. 统一项目中的 Kotlin 和 Compose 版本，避免版本不匹配带来的问题
3. 关注官方更新，等待对多模块资源处理的完整支持

总结

Compose Multiplatform 的资源系统在不断演进中，开发者需要了解不同版本间的兼容性差异。对于 Wasm 平台的特殊需求，合理配置构建流程是关键。随着框架的成熟，这些临时解决方案将不再必要，但在过渡期间，理解底层机制有助于解决问题。