Android集成Bitmovin与Purchasely重复类冲突 如何配置exclude规则

第一步：定位exclude需要的group、module信息 #

• 不要靠肉眼匹配重复类名猜测依赖坐标，直接在项目根目录终端执行依赖树查询命令：
  ./gradlew app:dependencies --configuration debugRuntimeClasspath
• 从输出的依赖树中，找到和你识别到的重复类所属的对应依赖项，每一行依赖的格式为group名:module名:版本号，直接截取前两段即为需要填入exclude配置的参数。
• 举例：如果依赖树中查到重复类来自com.google.code.gson:gson:2.9.0，对应的exclude配置即为exclude group: 'com.google.code.gson', module: 'gson'。

第二步：确定exclude的挂载位置 #

• 遵循*“高版本兼容优先、匹配主SDK要求优先”*的挂载规则：
  • 对比两个SDK传递引入的重复依赖版本，把exclude挂在版本更低、与SDK自身主依赖要求版本不匹配的那一方。比如Bitmovin传递引入okhttp 4.9.0，而Purchasely主依赖要求okhttp 4.12.0，就把okhttp的exclude挂在Bitmovin的依赖块下，让Gradle最终统一采用Purchasely要求的高版本依赖。
  • 如果两个SDK传递引入的重复依赖版本完全一致，任意挂在某一方的依赖块下即可，Gradle只会保留一份统一的依赖副本，不会出现重复打包。
• 严格禁止的操作：不要对同一个重复依赖，在两个SDK的依赖块里同时添加exclude，这种配置会直接把该依赖从全项目构建产物中剔除，100%触发运行时类找不到异常。
• 配置参考示例：

implementation ("com.bitmovin.player:playercore:2.64.0"){
   // 把从依赖树查到的、需要排重的依赖信息填进来
   exclude group: 'com.squareup.okhttp3', module: 'okhttp'
}
implementation ("io.purchasely:core:2.4.5"){
   // 不要再在这里重复配置已经在Bitmovin块下加过的exclude
}
// 若两个SDK对同一个依赖的版本要求跨度较大，直接在最外层统一声明兼容版本即可
implementation 'com.squareup.okhttp3:okhttp:4.12.0'

排重操作的功能风险判断 #

• 正常exclude操作只是告诉Gradle“不要从我挂载的当前SDK依赖链中拉取指定的传递依赖”，不会将该依赖从全项目移除，只要另一个SDK的依赖链中保留了对应兼容版本的依赖，就不会导致SDK功能失效。
• 只有当满足两个条件时，才会出现运行时异常：一是误操作将同一个依赖从两个SDK的依赖链中全部排除，导致构建产物中完全缺失该类；二是最终统一采用的依赖版本低于某一个SDK要求的最低兼容版本，触发SDK内部接口调用不匹配。
• 验证功能有效性的标准：只要最终项目统一的依赖版本≥两个SDK分别要求的最低兼容版本，就不会出现运行时异常。

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