在库模块使用Realm打包为aar后是否需要在主应用额外配置依赖？

核心结论 #

你无法仅通过库模块导出全部Realm配置，主应用必须补充Realm插件相关配置，同时需要调整库模块的依赖声明规则，二者缺一不可。

问题原因 #

普通第三方库仅包含运行时类资源，使用implementation声明即可通过AAR传递依赖，但Realm存在特殊机制：

• Realm依赖Gradle插件完成编译期字节码插桩，会修改模型类、生成配套辅助逻辑，该插件属于编译构建流程的一部分，无法被打包进AAR传递给上层项目
• 你遇到的NoClassDefFoundError报错同时和依赖传递规则有关，默认implementation声明的依赖不会被导出到上层项目

具体修复步骤 #

• 调整自定义库模块的Realm依赖声明：将原来的implementation "io.realm:realm-android-library:xxx"改为api "io.realm:realm-android-library:xxx"，确保Realm的运行时类可以传递到主应用
• 主项目级build.gradle添加Realm插件依赖，版本必须和库模块使用的版本完全一致：

  classpath "io.realm:realm-gradle-plugin:10.8.0"
  

• 主应用模块级build.gradle添加Realm插件引用：

  apply plugin: 'realm-android'
  

  如果使用plugins DSL写法则改为：

  id 'realm-android'
  

补充说明 #

• 如果你将自定义库发布到Maven仓库（本地/远程均可），可以通过POM文件自动传递Realm的运行时依赖，主应用无需额外手动添加Realm的运行时依赖，但插件配置仍需主应用自行添加，这是Gradle的机制限制，不存在规避方案
• 库模块中定义的Realm模型类无需在主应用重复定义，主应用配置插件后编译时会自动扫描全项目的模型类生成对应逻辑

内容的提问来源于stack exchange，提问作者XCarb