工具和库的相互依存关系

构建依赖项是成功构建项目所需的外部组件。build 可以依赖于库、插件、子项目、Android SDK、Kotlin 和 Java 编译器等工具、Android Studio 等开发环境以及 Gradle 本身。

每个依赖项本身可能还需要其他依赖项。我们将这些称为“传递依赖项”，它可以快速增加应用使用的整体依赖项。当您想要升级依赖项（无论是库、工具还是 Android SDK）时，该升级可能会级联，从而升级许多其他依赖项。

这通常不会造成任何困扰，因为许多库都采用称为语义版本控制的方案。这些库会限制它们做出的更改类型，以与较低版本兼容。

语义版本控制遵循 major.minor.patch 格式。例如，在版本号 4.8.3 中，4 表示 major 版本，8 表示 minor 版本，3 表示 patch 编号。当 major 部分发生变化时，库的 API 或行为可能会发生重大变化。这可能会影响您的构建或应用行为。

当 minor（新功能）或 patch（问题修复）部分发生更改时，库开发者会告诉您库仍然兼容，应该不会影响您的应用。

请务必留意此类更改，您可以使用多种依赖项升级工具来帮助您。

作品中的关系

Android build 包含以下关系：

• 源代码 - 您可以控制的代码和资源
• 库依赖项 - 构建项目和子项目时包含的外部库或模块
• 工具 - 将源代码转换为应用或库的编译器、插件和 SDK

源代码

源代码是您在应用或库中编写的 Kotlin 或 Java 代码。（如需详细了解如何使用 C++，请参阅 Android NDK。）

源代码依赖于库（包括 Kotlin 和 Java 运行时库）及 Android SDK，并需要对应的 Kotlin 或 Java 编译器。

某些源代码包含需要额外处理的注解。例如，如果您编写 Jetpack Compose 代码，则需要添加 Compose Kotlin 编译器插件需要处理的注解，例如 @Composable。其他注解可以由 Kotlin 符号处理器 (KSP) 或单独的注解处理工具处理。

库依赖项

库包含作为应用一部分拉入的字节码。项目可以是 Java JAR、Android 库 (AAR) 或 build 中的子项目。许多库都遵循语义版本控制，这可帮助您了解它们在升级后何时保持兼容（或不兼容）。

库可能会依赖于其他库以进行重复使用，这称为传递依赖项。这样可以减少您必须明确管理的依赖项；您指定直接使用的依赖项，Gradle 会将其与传递依赖项一起拉取。请注意，在升级直接依赖项时，它们可能会升级这些传递依赖项。

有时，库在运行时 (minSdk) 或编译时 (compileSdk) 可能需要最低版本的 Android SDK。当库使用 Android SDK 或其提供的 JDK API 中包含的函数时，就需要这样做。应用的有效 minSdk 是应用及其所有直接和传递库依赖项请求的最高 minSdk。

使用某些库可能需要使用特定的 Gradle 插件。这些辅助插件通常会安装 Kotlin 符号处理器或其他注解处理器，这些处理器会生成代码或修改源代码的编译，以支持您使用库功能。例如，Jetpack Room 包含注解和一个 KSP，可将其转换为生成的代码以检索和修改数据库中的数据。Jetpack Compose 要求 Compose 编译器插件修改带注解的函数，以管理重新运行该函数的方式和时间。

工具

Gradle 范围

Gradle 会将库依赖项划分到不同的作用域（在 Gradle API 中称为配置），以便您指定要用于 build 不同部分的不同组库依赖项。例如，您可能不希望在已发布的应用或库中包含 JUnit 等测试库，但又希望在构建和执行单元测试时希望有这些库。您还可以使用作用域添加符号或注解处理器来分析代码。

例如，AGP 定义了 implementation 和 api 范围，您可以通过这些方式指定是否应向子项目的用户公开依赖项。如需了解 Android build 中使用的这些作用域及其他作用域的说明，请参阅配置依赖项。

在 build 文件的 dependencies 代码块中，以 group:artifact:version 字符串的形式添加库依赖项：

// In a module-level build script
// explicit dependency strings ("group:artifact:version")
dependencies {
    implementation("com.example:library1:1.2.3")
    api("com.example:library2:1.1.1")
}

// In a module-level build script
// explicit dependency strings ("group:artifact:version")
dependencies {
    implementation 'com.example:library1:1.2.3'
    api 'com.example:library2:1.1.1'
}

也可以在版本目录中执行此操作：

# Version catalog - gradle/libs.versions.toml
[versions]
exampleLib = "1.2.3"
examplePlugin = "2.3.4"

[libraries]
example-library = { group = "com.example", name = "library", version.ref = "exampleLib" }

[plugins]
example-plugin = { id = "com.example.plugin", version.ref = "examplePlugin" }

并在构建文件中指定生成的变量：

// In a module-level build script
// Using a version catalog
plugins {
    alias(libs.plugins.example.plugin)
}

dependencies {
    implementation(libs.example.library)
}

// In a module-level build script
// Using a version catalog
plugins {
    alias(libs.plugins.example.plugin)
}

dependencies {
    implementation libs.example.library
}