Android排除问题类：Gradle依赖引入遇ProGuard警告未解决

我之前也碰到过一模一样的糟心事——用Gradle引依赖时触发ProGuard警告，试了常规的排除包方案完全没用，那种无力感太懂了。咱们先把问题掰明白：你遇到的Warning: library class ... depends on program class ...警告，核心原因就是不规范的第三方库打包了Android系统已经自带的类，比如你提到的org.w3c.dom、org.xml.sax、org.xmlpull.v1这些包，ProGuard会把这种重复当成潜在冲突来告警。

下面给你几个亲测有效的解决步骤，按顺序来：

• 第一步：精准定位问题依赖
  先搞清楚到底是哪个依赖带了重复类，执行Gradle命令生成依赖树：

  # Mac/Linux
  ./gradlew app:dependencies
  # Windows
  gradlew.bat app:dependencies
  

  在输出里找你最近新增的依赖，看它的子依赖有没有包含那些系统自带的包，这一步很关键，别瞎猜排除路径。

• 第二步：用更精准的依赖排除规则
  有时候单纯exclude package不生效，是因为依赖层级或者包名匹配的问题，试试指定group和module来排除：
  比如排查出是com.example:trouble-lib:2.0.0带了重复的org.w3c.dom，就在Gradle里这么写：

  implementation ('com.example:trouble-lib:2.0.0') {
      // 排除具体的模块
      exclude group: 'org.w3c', module: 'dom-api'
      // 如果是整个包都要排除，直接写
      // exclude group: 'org.w3c'
  }
  

• 第三步：让ProGuard忽略这类警告
  如果排除还是没效果（比如有些库把重复类直接打包在自己的jar里，没法通过依赖排除去掉），那直接在你的proguard-rules.pro里添加规则，告诉ProGuard别纠结这些重复类：

  # 忽略Android系统已存在类的依赖警告
  -dontwarn org.w3c.dom.**
  -dontwarn org.xml.sax.**
  -dontwarn org.xmlpull.v1.**
  

  放心用这个规则，这些类本来就是Android系统自带的，第三方包里的重复类不会被打包进你的APK，只是ProGuard太严谨才告警。

• 额外提醒
  如果你的项目里同时引入了多个带重复类的库，可能需要检查有没有依赖版本冲突，用force强制指定某个版本，但这种情况不多见，优先用前面的方法。

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