Compose Destinations 多模块项目中的重复类问题解析

问题背景

在 Android 开发中，随着 Jetpack Compose 的普及，Compose Destinations 作为一款流行的导航库，在从 1.x 版本升级到 2.0 版本时，部分开发者遇到了一个典型的多模块项目构建问题。具体表现为构建过程中出现"ModuleRegistryKt 类被多次定义"的错误，这通常发生在包含多个功能模块的 Android 项目中。

问题现象

当开发者在多模块项目中使用 Compose Destinations 2.0.0-alpha02 版本时，构建系统会报错提示 _ModuleRegistryKt 类在多个模块中被重复定义。错误信息显示这个类在两个不同的模块转换目录中同时存在，导致 Dex 合并时发生冲突。

问题根源

这个问题本质上是由代码生成机制在多模块环境下的处理不当引起的。Compose Destinations 的代码生成器在每个模块中都生成了相同名称的内部类文件，而 Android 构建系统在最终合并所有模块的 DEX 文件时，发现了这些重复的类定义。

解决方案

Compose Destinations 的维护者在 2.0.0-alpha03 版本中修复了这个问题。修复方案主要是修改了代码生成逻辑，确保在不同模块中生成的辅助类具有唯一的名称，避免了类名冲突。

迁移建议

对于正在从 1.x 版本迁移到 2.0 版本的开发者，建议：

1. 确保按照迁移指南正确配置每个模块
2. 为每个模块指定唯一的代码生成包名
3. 遇到类似问题时及时升级到最新修复版本
4. 注意检查多模块项目中的依赖关系

技术启示

这个问题给我们提供了一个很好的案例，展示了在开发多模块支持的代码生成工具时需要考虑的关键点：

1. 生成的辅助类必须具有模块唯一性
2. 需要考虑 Android 构建系统的类合并机制
3. 版本升级时需要特别注意兼容性问题

Compose Destinations 团队快速响应并修复问题的态度也值得赞赏，这体现了开源项目维护者对用户体验的重视。