如何查看 Android 项目的依赖结构树

如何查看 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 图形界面

1. 打开项目后，点击 View > Tool Windows > Gradle。
2. 在右侧的 Gradle 工具窗口中，选择模块（如 :app）。
3. 展开 Tasks > other ，双击 dependencies 任务。
4. 任务运行后，依赖树将显示在 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 配置不完整。

解决方法

1. 列出所有任务：

   ./gradlew tasks --all

2. 手动配置任务分组：在 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