Gradle中如何让两个库模块共用依赖避免重复声明

你当前已经通过api配置打通了库到应用层的依赖传递链路，要解决两个库的重叠依赖重复声明问题，有两种可落地的兼容方案：

方案1：搭建无业务代码的公共依赖聚合模块 #

• 新建一个Gradle模块，模块内不需要编写任何业务逻辑代码，仅承担依赖聚合的职责
• 将两个库所有重叠的依赖项，统一在这个公共模块的dependencies块中用api声明
• 库模块A、库模块B删除自身配置里的重叠依赖声明，改为将这个公共依赖模块作为自身的api依赖引入
• 由于公共模块使用api暴露依赖，原有依赖传递逻辑完全不受影响：接入A、B的应用模块依然不需要额外重复声明这些依赖；同时还能从根源上避免两个库因为依赖版本不一致产生的冲突，后续升级依赖版本也只需要在公共模块修改一次即可

方案2：通过Gradle版本目录做全局依赖收敛 #

• 把所有重叠依赖的坐标、版本，统一配置在项目根目录的gradle/libs.versions.toml版本目录文件中，形成全项目统一的依赖条目
• 库模块A、库模块B引用这些重叠依赖时，全部从版本目录中读取同一个条目，删除各自硬编码的重复依赖声明
• 该方案不需要额外新建模块，适合两个库分属不同业务分组、不想新建聚合层的场景，Gradle会自动对相同坐标的依赖做合并，完全不会产生重复配置

关键注意事项 #

• 不要为了图方便，直接把库A作为库B的api依赖引入来复用依赖，这会让所有依赖库B的模块强制加载库A的全部代码和传递依赖，直接导致安装包体积无意义增长
• 放在收敛层的共用依赖，必须保持api的配置方式，不要换成implementation——一旦换成implementation，原本打通的依赖传递链路会被切断，下游应用模块就需要自己重新声明这些依赖，完全违背之前用api配置的初衷

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