第 3 部分：依赖管理

了解项目依赖项和 Gradle 依赖项管理的基础知识。

在本节中，您将：

了解项目依赖关系
检查项目依赖关系
使用构建扫描来分析依赖关系
更新项目依赖项
了解传递依赖
添加版本目录

步骤 0. 开始之前

您在第 1 部分中初始化了 Java 应用程序。
您在第 2 部分中运行了多项任务。

步骤 1. 了解版本目录

版本目录用于在中央位置声明项目的所有直接依赖项。

它由 Gradle init 创建gradle/libs.versions.toml并在子项目构建文件中引用。

库.版本.toml

[versions]
guava = "32.1.2-jre"
junit-jupiter = "5.10.0"

[libraries]
guava = { module = "com.google.guava:guava", version.ref = "guava" }
junit-jupiter = { module = "org.junit.jupiter:junit-jupiter", version.ref = "junit-jupiter" }

要引用版本目录中定义的库：

dependencies {
    implementation(libs.guava)
    testImplementation(libs.junit.jupiter)
}

dependencies {
    implementation libs.guava
    testImplementation libs.junit.jupiter
}

在本例中，libs.guava请libs.junit.jupiter参考您的版本目录中定义的相应库。

使用该versions.junit.jupiter语法是因为键包含一个特殊字符的连字符。

与直接在构建脚本中声明依赖项相比，版本目录具有许多优点：

Gradle 从目录生成类型安全的访问器，以便您可以在 IDE 中使用自动完成功能轻松添加依赖项。
它是声明依赖项版本的中心位置，以便任何更改都适用于每个子项目。

步骤 2.了解项目依赖性

Gradle 为依赖管理和自动化提供了出色的支持。

让我们再看看我们的构建脚本（文件build.gradle(.kts)），特别是以下部分：

repositories {
    // Use Maven Central for resolving dependencies.
    mavenCentral()
}

dependencies {
    // Use JUnit Jupiter for testing.
    testImplementation(libs.junit.jupiter)

    testRuntimeOnly("org.junit.platform:junit-platform-launcher")

    // This dependency is used by the application.
    implementation(libs.guava)
}

repositories {
    // Use Maven Central for resolving dependencies.
    mavenCentral()
}

dependencies {
    // Use JUnit Jupiter for testing.
    testImplementation libs.junit.jupiter

    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'

    // This dependency is used by the application.
    implementation libs.guava
}

Gradle 依赖管理中的一些关键概念包括：

存储库- 依赖项的来源 →mavenCentral()

Maven Central是由 Maven 社区提供并由 Sonatype支持的 jar 文件、插件和库的集合。它是 Java 事实上的公共工件存储，并被许多构建系统使用。

依赖关系- 通过配置类型声明的依赖关系 →libs.junit.jupiter和libs.guava

Gradle 需要特定信息来查找依赖项。让我们看看libs.guava→com.google.guava:guava:32.1.2-jre和libs.junit.jupiter→ org.junit.jupiter:junit-jupiter-api:5.9.1；它们细分如下：

描述 com.google.guava:番石榴:32.1.2-jre org.junit.jupiter:junit-jupiter-api:5.9.1

	描述	com.google.guava:番石榴:32.1.2-jre	org.junit.jupiter:junit-jupiter-api:5.9.1
团体	组织的标识符	`com.google.guava`	`org.junit.jupiter`
姓名	依赖标识符	`guava`	`junit-jupiter-api`
版本	要导入的版本号	`32.1.2-jre`	`5.9.1`

团体

组织的标识符

com.google.guava

org.junit.jupiter

姓名

依赖标识符

guava

junit-jupiter-api

版本

要导入的版本号

32.1.2-jre

5.9.1

步骤 3. 理解传递依赖

传递依赖是依赖的依赖。

为了使我们的guava依赖项正常工作，它需要一个名为的库failureaccess。因此failureaccess是项目的传递依赖。

步骤 4.查看项目依赖关系

您可以使用以下命令在终端中查看依赖关系树./gradlew :app:dependencies：

$ ./gradlew :app:dependencies

> Task :app:dependencies

------------------------------------------------------------
Project ':app'
------------------------------------------------------------

...

compileClasspath - Compile classpath for source set 'main'.
\--- com.google.guava:guava:32.1.2-jre
     +--- com.google.guava:guava-parent:32.1.2-jre
     |    +--- com.google.code.findbugs:jsr305:3.0.2 (c)
     |    +--- org.checkerframework:checker-qual:3.33.0 (c)
     |    +--- com.google.errorprone:error_prone_annotations:2.18.0 (c)
     |    \--- com.google.j2objc:j2objc-annotations:2.8 (c)
     +--- com.google.guava:failureaccess:1.0.1
     +--- com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava
     +--- com.google.code.findbugs:jsr305 -> 3.0.2
     +--- org.checkerframework:checker-qual -> 3.33.0
     +--- com.google.errorprone:error_prone_annotations -> 2.18.0
     \--- com.google.j2objc:j2objc-annotations -> 2.8

输出清楚地描述了对com.google.guava:guava:32.1.2-jre的依赖com.google.guava:failureaccess:1.0.1。

步骤 5. 在 Build Scan® 中查看依赖关系

要使用Build Scan查看依赖关系，请使用可选标志运行构建任务--scan。

在该tutorial目录中，输入以下命令并按照提示接受条款：

$ ./gradlew build --scan

BUILD SUCCESSFUL in 423ms
7 actionable tasks: 7 up-to-date

Publishing a build scan to scans.gradle.com requires accepting the Gradle Terms of Service defined at https://gradle.com/terms-of-service. Do you accept these terms? [yes, no] yes

Gradle Terms of Service accepted.

Publishing build scan...
https://gradle.com/s/link

构建扫描是构建的可共享且集中的记录，可作为 Gradle 的免费服务提供。

单击提示中提供的链接：https://gradle.com/s/link。

您必须接受服务条款才能使用构建扫描。

您需要使用您的电子邮件激活构建扫描：

您将在收件箱中收到扫描的最终链接，如下所示：

打开菜单中的“依赖关系”compileClasspath选项卡并展开、runtimeClasspath、testCompileClasspath和testRuntimeClasspath：

正如预期的那样，我们可以看到声明的依赖项junit，并被guavaGradle 用于编译、运行和测试应用程序。

展开com.google.guava:guava:32.1.2-jre并org.junit.jupiter:junit-jupiter:5.9.1在窗口中：

junit和下有几个传递依赖关系guava。例如，com.google.code.findbugs:jsr305:3.0.2传递依赖就来自于com.google.guava:guava:32.1.2-jre依赖。

步骤 6. 更新项目依赖项

添加和更改依赖项是在构建文件中完成的。

让我们更改版本guava并看看这如何影响依赖关系树。

guava将版本目录中的依赖关系更改为：

gradle/libs.version.toml

[versions]
guava = "30.0-jre"
junit-jupiter = "5.10.0"

[libraries]
guava = { module = "com.google.guava:guava", version.ref = "guava" }
junit-jupiter = { module = "org.junit.jupiter:junit-jupiter", version.ref = "junit-jupiter" }

如果您使用 IntelliJ 更改文件，请不要忘记单击syncGradle 按钮：

运行./gradlew build --scan并查看构建扫描结果：

./gradlew :app:dependencies在终端中运行来检查依赖树中的变化：

...

compileClasspath - Compile classpath for source set 'main'.
\--- com.google.guava:guava:30.0-jre
     +--- com.google.guava:failureaccess:1.0.1
     +--- com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava
     +--- com.google.code.findbugs:jsr305:3.0.2
     +--- org.checkerframework:checker-qual:3.5.0
     +--- com.google.errorprone:error_prone_annotations:2.3.4
     \--- com.google.j2objc:j2objc-annotations:1.3

...

很明显，guava依赖项已更新到版本30.0，传递依赖项也已更改。

步骤 7. 运行 Java 应用程序

最后，确保run在终端或 IDE 中使用该任务一切正常：

./gradlew run

> Task :app:compileJava UP-TO-DATE
> Task :app:processResources NO-SOURCE
> Task :app:classes UP-TO-DATE

> Task :app:run
Hello World!

下一步： 应用插件>>

此页面是否有帮助？