如何移除项目全局support-v4依赖？gradle配置无效问题排查

嘿，我来帮你捋捋这个问题！你用configurations { all*.exclude module: 'support-v4' }来排除依赖的思路没问题，但执行后还有support-v4相关方法残留，大概率是以下几个原因导致的，对应解决办法如下：

1. 第三方依赖内嵌了support-v4的代码 #

有些第三方库不是通过Gradle依赖引用support-v4，而是直接把support-v4的class文件打包进了自己的aar/jar里，这种情况下你的exclude配置是无法生效的。

• 解决办法：
  • 执行./gradlew 你的模块名:dependencies（比如./gradlew app:dependencies）生成依赖树，仔细排查哪个库带了support-v4相关代码。
  • 如果找到对应的库，优先尝试升级该库的最新版本（很多库已经迁移到AndroidX，不再依赖support-v4）；如果没有新版本，可能需要考虑替换成其他替代库，或者使用jarjar工具手动移除内嵌的support-v4类。

2. 项目自有代码直接引用了support-v4 #

如果你的项目代码里直接写了android.support.v4包下的类或方法，即使排除了依赖，这些引用依然会存在，编译时会报错或者保留相关符号。

• 解决办法：
  • 全局搜索项目中的android.support.v4关键词，把所有相关引用替换成AndroidX的对应类（比如androidx.core包下的类基本都是support-v4的替代）。
  • 更彻底的方式是直接通过Android Studio的Refactor > Migrate to AndroidX工具完成全项目的AndroidX迁移，Google已经停止维护support库，迁移后能从根源上避免这类问题。

3. Gradle缓存未彻底清理 #

有时候仅执行clean任务不足以清除所有缓存，旧的依赖文件可能还残存在Gradle缓存目录里，导致重建时又被引入。

• 解决办法：
  • 删除项目根目录下的.gradle文件夹，以及各个模块下的build文件夹。
  • 重新执行./gradlew clean assembleDebug（或你需要的构建任务），确保完全从头构建。

4. 多模块项目中仅部分模块配置了exclude #

如果你的项目是多模块结构，只在单个模块添加exclude配置的话，其他模块的support-v4依赖依然会被引入，最终打包到APK里。

• 解决办法：
  • 在根项目的build.gradle中添加全局排除配置，确保所有模块都生效：

    subprojects {
        configurations {
            all*.exclude module: 'support-v4'
        }
    }
    

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