如何在Android项目中查找未使用的依赖项？

你之前使用的nebula/gradle-lint属于通用型Gradle lint工具，对Android项目的资源引用、动态调用等场景适配不足，所以检测结果准确率不高，以下是适配Android项目的可行方案：

1. 使用Android Studio内置Lint检测 #

这是官方提供的原生检测能力，适配Android项目的各类引用场景，操作门槛低：

• 打开Android Studio，依次点击 Analyze > Run Inspection by Name
• 搜索 Unused dependencies 选项，选择需要检测的模块执行扫描
• 扫描结果会明确标注未被项目代码直接引用的依赖，可结合业务场景验证后删除
• 注意：如果依赖存在仅运行时调用（反射、动态加载、跨模块资源引用）的场景，需要手动确认依赖必要性后再操作，避免线上运行故障

2. 使用专门的Gradle依赖分析插件 #

com.autonomousapps.dependency-analysis 是专门针对JVM/Android项目的依赖分析工具，检测准确率远高于通用lint工具，操作步骤如下：

• 在项目根目录的build.gradle中添加插件配置：

plugins {
  id "com.autonomousapps.dependency-analysis" version "1.25.0" apply false
}

• 在需要检测的模块（一般是app模块、功能子模块）的build.gradle中应用插件：

plugins {
  id "com.autonomousapps.dependency-analysis"
}

• 终端执行扫描命令：./gradlew buildHealth
• 扫描完成后，会在对应模块的build/reports/dependency-analysis目录下生成详细报告，分类列出未使用的依赖、可调整依赖配置（比如从implementation改为compileOnly）的条目，可直接参考报告调整依赖配置

3. 手动排查工具漏检场景 #

所有自动化工具都存在漏检的特殊场景，需要手动核对以下情况：

• 仅引入资源、so库的依赖：如果某依赖只提供了图片资源、so动态库，没有代码调用，自动化工具会误判为未使用，需要手动确认
• 跨模块共享依赖：如果依赖在base模块声明，供多个子模块调用，单模块扫描容易误判为未使用，需要核对全项目引用情况
• 动态注册类的依赖：比如依赖里的类是在AndroidManifest里配置的、或者通过SPI机制加载的，没有直接代码引用，也会被误判为未使用，需要手动验证

额外体积优化建议 #

完成依赖清理后，还可以通过以下操作进一步缩减包体积：

• 点击Android Studio的 Refactor > Remove Unused Resources 一键清理冗余的布局、图片、字符串等资源
• 把非透明png图片转换为webp格式，可减少40%以上的图片资源体积
• 开启R8/ProGuard全量压缩和资源压缩，自动剔除未被引用的代码和资源

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