如何通过 Gradle 工具查询一个库的完整依赖树结构？

本文共计964个文字，预计阅读时间需要4分钟。

使用Gradle获取库的依赖关系树对于管理项目依赖至关重要。以下是如何操作的基本步骤：

了解 POM 文件

POM (Project Object Model) 文件是一个 XML 文件，包含了项目的基本信息，包括groupId、artifactId、version以及最重要的依赖关系。对于 Android 库（AAR），其依赖信息通常存储在与 AAR 文件一起发布的 POM 文件中。

例如，com.google.firebase:firebase-firestore:24.4.0 库的 POM 文件可以在 Google Maven 仓库中找到。该 POM 文件定义了该库的直接依赖，例如 androidx.annotation:annotation 和 com.google.android.gms:play-services-base。

以下是 com.google.firebase:firebase-firestore:24.4.0 库的 POM 文件示例：

<?xml version='1.0' encoding='UTF-8'?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://www.w3.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.google.firebase</groupId> <artifactId>firebase-firestore</artifactId> <version>24.4.0</version> <packaging>aar</packaging> <dependencies> <dependency> <groupId>androidx.annotation</groupId> <artifactId>annotation</artifactId> <version>1.1.0</version> <scope>compile</scope> <type>jar</type> </dependency> <dependency> <groupId>com.google.android.gms</groupId> <artifactId>play-services-base</artifactId> <version>18.0.1</version> <scope>compile</scope> <type>aar</type> </dependency> </dependencies> <name>firebase-firestore</name> <licenses> <license> <name>The Apache Software License, Version 2.0</name> <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url> <distribution>repo</distribution> </license> </licenses> </project>

需要注意的是，com.google.android.gms:play-services-base 本身也有自己的 POM 文件，其中定义了其自身的依赖关系。要获取完整的依赖树，你需要递归地解析每个依赖项的 POM 文件。

使用 Gradle dependencies 命令

Gradle 提供了一个 dependencies 命令，可以用来查看项目的传递依赖。传递依赖是指项目直接依赖的库所依赖的库。默认情况下，Gradle 会自动解析这些传递依赖。

要使用 dependencies 命令，首先需要创建一个 Gradle 项目。以下是一个简单的示例：

1. 创建一个新的目录：mkdir gradleExp
2. 进入该目录：cd gradleExp
3. 使用 Gradle 初始化项目：gradle init (选择 1. basic, 1. groovy, 随便一个项目名称)
4. 编辑 build.gradle 文件，添加以下内容：

plugins { id 'java' } repositories { google() mavenCentral() } dependencies { implementation "com.google.firebase:firebase-firestore:24.4.0" }

请确保 repositories 部分包含 google() 和 mavenCentral()，否则 Gradle 可能无法找到所需的依赖。

5. 运行 gradle dependencies 命令，可以查看所有依赖关系。
6. 可以使用 gradle dependencies --configuration compileClasspath 命令来只显示编译时所需的依赖关系。

注意事项

• gradle dependencies 命令显示的是传递依赖，即 Gradle 自动解析的依赖关系。
• 要获取完整的依赖树，可能需要编写自定义任务来递归地解析 POM 文件。
• 确保 build.gradle 文件中的 repositories 部分包含所有需要的仓库，例如 google() 和 mavenCentral()。

总结

虽然 Gradle 本身没有直接获取库的完整依赖树的命令，但通过解析 POM 文件和使用 gradle dependencies 命令，可以有效地管理和了解项目的依赖关系。 了解 POM 文件的结构和 Gradle 的依赖管理机制对于构建稳定和可维护的项目至关重要。