如何查看 Android 项目的依赖结构树
在 Android 开发中，查看依赖结构树有助于了解项目的依赖关系，快速定位依赖冲突或冗余问题。本文将介绍四种查看依赖结构树的方法，以及常见问题的解决方案。
方法 1：使用 Gradle 命令
1. 查看依赖树
1.1 查看所有模块的依赖树
运行以下命令：
./gradlew dependencies
- 作用范围：项目的所有模块。
- 输出内容：显示每个模块的依赖信息，包括其配置和依赖树。
- 适用场景：
- 快速了解整个项目的依赖概况。
- 排查全局依赖冲突。
1.2 查看特定模块的依赖树
运行以下命令：
./gradlew :app:dependencies
- 作用范围：仅作用于指定模块（如
:app）。 - 输出内容：只显示指定模块的依赖信息。
- 适用场景：
- 聚焦分析单个模块。
- 深入了解模块的依赖关系和版本冲突。
命令区别
| 特性 | ./gradlew dependencies | ./gradlew :app:dependencies |
|---|---|---|
| 作用范围 | 整个项目的所有模块 | 指定模块（如 :app） |
| 输出内容 | 所有模块的依赖信息 | 单一模块的依赖信息 |
| 适用场景 | 快速了解项目全局依赖 | 深入分析某模块依赖 |
2. 查看特定配置的依赖树
可以指定 Gradle 配置（如 implementation）查看依赖树：
./gradlew :app:dependencies --configuration implementation
方法 2：使用 Android Studio 图形界面
- 打开项目后，点击 View > Tool Windows > Gradle。
- 在右侧的 Gradle 工具窗口中，选择模块（如
:app）。 - 展开 Tasks > other，双击 dependencies 任务。
- 任务运行后，依赖树将显示在 Run 窗口中。
注意：如果没有找到 dependencies 任务，可以尝试以下操作：
- 点击右键选择 Refresh Gradle Project。
- 检查项目的 Gradle 插件版本是否兼容。
方法 3：使用第三方插件
1. Gradle Dependency Graph Generator
通过该插件可以生成图形化依赖关系。
添加插件
在模块的 build.gradle 中添加：
plugins {
id "com.vanniktech.dependency.graph.generator" version "0.7.0"
}
生成依赖关系图
运行以下命令：
./gradlew generateDependencyGraph
- 输出：
.dot文件或.png文件，位于项目目录中。
2. Dependency Analysis Plugin
- 安装：在 Android Studio 的插件市场中搜索 “Dependency Analysis” 并安装。
- 功能：提供更详细的依赖信息，并标记冗余依赖或冲突。
方法 4：分析依赖冲突
1. 添加 --scan 标志
运行以下命令：
./gradlew :app:dependencies --scan
生成一个 URL，通过浏览器查看详细的依赖报告。
2. 使用 resolutionStrategy
在模块的 build.gradle 文件中添加以下代码：
configurations.all {
resolutionStrategy {
eachDependency { details ->
println "${details.requested.group}:${details.requested.name}:${details.requested.version}"
}
}
}
运行任意构建命令，查看依赖详情。
常见问题及解决方案
1. 任务未显示或找不到
原因
Gradle 可能隐藏了某些任务，或者项目的 Gradle 配置不完整。
解决方法
-
列出所有任务：
./gradlew tasks --all -
手动配置任务分组：在 build.gradle中添加：
tasks.named("dependencies") { group = "help" }
2. 查看重复依赖或冲突
运行以下命令，检查依赖冲突或重复依赖：
./gradlew :app:dependencies | grep "具体库名"
3. 环境变量问题导致任务无法运行
如果 Java 版本不匹配，需要临时设置环境变量：
在 PowerShell 中设置临时环境变量
$env:JAVA_HOME="D:\jdk19"
$env:PATH="$env:JAVA_HOME\bin;$env:PATH"
验证后运行 Gradle 命令：
./gradlew dependencies
