Compose Multiplatform 多模块资源加载问题解析

背景介绍

JetBrains 推出的 Compose Multiplatform 框架在 1.6.0 版本中引入了稳定的资源管理功能，允许开发者在跨平台应用中使用图片、字体等资源文件。然而，在实际开发中，当项目采用多模块架构时，iOS 平台会出现资源加载失败的问题。

问题现象

在多模块项目中，当主应用模块依赖其他包含资源的子模块时，iOS 平台运行时会出现 org.jetbrains.compose.resources.MissingResourceException 异常。开发者不得不将所有子模块的资源文件手动复制到主应用模块中才能解决此问题。

技术分析

根本原因

Compose Multiplatform 的资源系统在 iOS 平台上的实现存在限制：

1. 资源打包机制在 iOS 平台上无法正确处理多模块场景
2. 资源查找路径在运行时仅包含主模块的资源目录
3. 缺少对模块间资源依赖关系的自动处理

影响范围

此问题主要影响：

• 采用模块化架构的项目
• 需要在多个模块中分散管理资源的场景
• iOS 平台（其他平台如 Android 和桌面端不受影响）

当前解决方案

在官方修复此问题前，开发者可以采用以下临时解决方案：

1. 资源集中管理：将所有资源文件统一放在主应用模块中
2. 手动复制资源：将子模块的资源文件复制到主模块的 resources 目录
3. 构建脚本自动化：通过 Gradle 脚本自动完成资源复制工作

未来展望

JetBrains 团队已经在开发此问题的修复方案，预计将在以下版本中提供支持：

• 需要 Kotlin Gradle 插件 2.0.0-Beta05 或更高版本
• 将实现真正的多模块资源支持
• 自动处理模块间的资源依赖关系

最佳实践建议

对于当前版本的项目开发，建议：

1. 暂时采用单一模块管理所有资源
2. 关注官方更新，及时升级到支持多模块资源的版本
3. 合理规划项目结构，为未来支持多模块资源做好准备

Compose Multiplatform 作为新兴的跨平台框架，其资源管理系统仍在不断完善中。理解当前限制并采用适当的工作方式，可以帮助开发者更高效地构建跨平台应用。