Apollo Kotlin插件在多模块Android项目中的Schema下载问题解析

问题背景

在Android开发中使用Apollo Kotlin插件进行GraphQL开发时，开发者经常需要从服务器下载GraphQL schema文件。标准的做法是在应用的build.gradle文件中配置Apollo插件，然后通过Android Studio的菜单工具下载schema。然而，当schema配置位于非主模块（如core模块）时，插件会出现无法识别下载任务的问题。

问题重现

开发者报告了一个典型场景：当Apollo配置位于项目中的子模块（如:core:data）而非主应用模块(:app)时，通过Android Studio的"Tools > Apollo > Download schema"菜单操作会提示"未找到下载schema任务"。而同样的配置如果放在主应用模块则能正常工作。

通过创建测试项目发现，当模块位于项目根目录下时（如:data），插件能正常工作；但当模块位于嵌套目录中时（如:core:data2），插件就无法识别配置。

技术分析

这个问题源于IntelliJ/Android Studio插件在查找Gradle模块时的实现限制。插件当前仅查找项目根目录下一级的模块，而没有递归查找所有层级的模块。具体来说，插件代码中模块查找逻辑只遍历了直接子模块，忽略了嵌套的子模块结构。

临时解决方案

在等待官方修复期间，开发者可以采用以下替代方案：

1. 通过命令行直接执行Gradle任务：

./gradlew :core:data:downloadServiceApolloSchemaFromIntrospection

2. 将schema配置暂时移至主应用模块或根目录下的直接子模块中

问题修复

官方已确认这是一个插件实现上的缺陷，并计划在下一个版本中修复。修复方案是改进模块查找逻辑，使其能够递归查找项目中的所有模块，而不仅限于第一层子模块。

最佳实践建议

对于多模块Android项目中的Apollo Kotlin使用，建议：

1. 保持schema配置的一致性 - 最好统一放在数据层模块中
2. 对于复杂项目结构，考虑使用Gradle的includeBuild或复合构建来简化模块结构
3. 定期检查插件更新，以获取最新的功能改进和问题修复

总结

这个问题展示了开发工具在复杂项目结构中可能遇到的挑战。虽然Apollo Kotlin插件在简单场景下工作良好，但在嵌套模块等复杂结构中可能需要进行额外适配。理解这些限制有助于开发者更好地规划项目结构和选择适当的工作流程。