Compose Multiplatform 多模块项目中 Android 资源处理指南

问题背景

在 Compose Multiplatform 1.6.10-beta01 版本中，官方宣布支持包含 Compose 资源的多模块项目和库发布。然而，开发者在实际使用中可能会遇到 Android 资源处理失败的问题，错误信息通常表现为：

Execution failed for task ':androidApp:processDebugResources'
AAPT2 aapt2-8.3.2-10880808-osx Daemon #0: Unexpected error during link

核心问题分析

这个问题通常源于两个关键配置错误：

1. 插件应用错误：在共享 UI 模块中错误地应用了 Android Application 插件而非 Android Library 插件
2. 资源过滤不当：在构建配置中设置了不恰当的 packagingFilters，导致必要的资源文件被错误排除

正确配置方案

1. 共享模块的插件配置

在共享 UI 模块（通常命名为 shared-ui 或类似的模块）中，应该应用 com.android.library 插件而非应用插件：

plugins {
    id("com.android.library")
    // 其他插件...
}

2. 资源过滤配置

确保不要在 Android 构建配置中过度过滤资源文件。以下是一个错误的配置示例：

android {
    packaging {
        resources {
            excludes += "/META-INF/{AL2.0,LGPL2.1}"
            // 避免过度排除其他必要资源
        }
    }
}

应该移除不必要的资源排除规则，特别是那些可能影响 Compose 资源处理的规则。

最佳实践建议

1. 模块职责分离：

   • 共享 UI 模块：使用 Android Library 插件
   • 应用模块：使用 Android Application 插件

2. 资源管理：

   • 确保所有 Compose 相关资源（如图片、字体等）被正确包含
   • 谨慎使用 packagingFilters，只排除确实不需要的文件

3. 版本兼容性：

   • 确保使用 Kotlin 2.0.0-Beta05 或更高版本
   • 保持 Compose Multiplatform 插件版本与 Kotlin 版本兼容

验证方案

配置完成后，可以通过以下步骤验证：

1. 清理项目（执行 ./gradlew clean）
2. 重新同步 Gradle 项目
3. 构建并运行 Android 应用模块

如果配置正确，资源处理任务应该能够顺利完成，应用也能正常显示 Compose UI 组件。

总结

正确处理 Compose Multiplatform 项目中的 Android 资源需要特别注意模块类型和资源过滤配置。通过遵循上述指南，开发者可以避免常见的资源链接错误，确保多模块项目能够顺利构建和运行。