词汇表

构建生成的 文件或目录，例如 JAR 文件、ZIP 发行包或原生可执行文件。

构建是 Gradle 执行的原子工作单元的集合。它由项目组成，这些项目拥有一系列任务。

Build Scan 是 Gradle 提供的一项服务，用于识别构建问题和构建性能。

build.gradle 脚本。

能力标识由一个或多个组件提供的特性。能力由类似于用于模块版本的坐标标识。默认情况下，每个模块版本都提供与其坐标匹配的能力，例如 com.google:guava:18.0。能力可用于表达组件提供多个特性变体，或者两个不同的组件实现相同的功能（因此不能一起使用）。有关更多详细信息，请参阅关于能力的部分。

模块的任何单个版本。

组件元数据规则是在从仓库获取组件元数据后修改组件元数据的规则，例如，添加缺失的信息或更正不正确的信息。与解析规则相反，组件元数据规则在解析开始之前应用。组件元数据规则被定义为构建逻辑的一部分，可以通过插件共享。有关更多信息，请参阅关于使用组件元数据规则修复元数据的部分。

配置是为特定目标分组在一起的依赖的命名集合。配置提供对底层已解析的模块及其产物的访问。有关更多信息，请参阅关于依赖配置以及可解析和可消费配置的部分。

Gradle 构建由两个主要阶段组成：配置阶段（不要与[sub:terminology_configuration] 实例混淆）和执行阶段。

构建在生态系统插件之上的[sub:terminology_plugin]，它将常见的约定应用于使用该插件的构建脚本。

请参阅跨项目配置。

跨项目配置是指在多项目构建中管理和自定义多个子项目。

subprojects {
    apply plugin: 'java'
    repositories {
        mavenCentral()
    }
    dependencies {
        testImplementation 'junit:junit:4.13.2'
    }
}

gradle.lifecycle.beforeProject {
    repositories {
        mavenCentral()
    }
}

tasks.register("customTask") {
    // Avoid this! Directly accessing outputs from another subproject's task
    def outputFile = project(":subprojectB").tasks.named("someTask").get().outputs.files.singleFile
    inputs.file(outputFile)
    doLast {
        println("Processing file from subprojectB: ${outputFile}")
    }
}

tasks.register("someTask") {
    def outputFile = layout.buildDirectory.file("output.txt")
    outputs.file(outputFile)
    doLast {
        outputFile.get().asFile.text = "Output from subprojectB"
        println("Generated output file in subprojectB: ${outputFile.get().asFile}")
    }
}

依赖是指向构建、测试或运行模块所需的另一段软件的指针。有关更多信息，请参阅关于声明依赖的部分。

依赖约束定义了模块需要满足的要求，以使其成为依赖的有效解析结果。例如，依赖约束可以缩小支持的模块版本集。依赖约束可用于表达传递依赖的此类要求。有关更多信息，请参阅关于升级和降级传递依赖的部分。

负责构建语言的[sub:terminology_plugin]，例如 Java (java 和 java-library)、Groovy、Scala、Android、Kotlin 等。许多插件由 Gradle 维护，并且是 Gradle 发行版的一部分。

Gradle 构建的第二个主要阶段，执行阶段在配置阶段完成后发生。这是执行所有任务操作的地方。

特性变体是表示组件特性的变体，可以单独选择或不选择。特性变体由一个或多个能力标识。有关更多信息，请参阅关于建模特性变体和可选依赖的部分。

Gradle 构建可以由一个或多个 Gradle 项目组成，并且通常使用根目录下的 settings.gradle(.kts) 文件进行配置。

增量构建仅执行必要的任务。如果我们运行任何源代码，Gradle 首先检查该源代码是否经历过任何先前的执行。如果代码有一些更改，则将执行该代码，但如果没有更改，则将跳过该代码的执行。

初始化脚本或 init 脚本由 Gradle 类型的实例支持。

MavenCentral 是托管 Maven 发布的主要仓库。它由一家名为 Sonatype 的公司运营，并且是许多生态系统的默认仓库。

随着时间推移演变的软件片段，例如 Google Guava。每个模块都有一个名称。每个模块版本都由模块版本最佳表示。为了方便消费，模块可以托管在仓库中。

模块的发布提供元数据。元数据是更详细地描述模块的数据，例如，关于产物位置或所需传递依赖的信息。Gradle 提供其自己的元数据格式，称为 Gradle 模块元数据 (.module 文件)，但也支持 Maven (.pom) 和 Ivy (ivy.xml) 元数据。请参阅关于理解 Gradle 模块元数据的部分，以获取有关支持的元数据格式的更多信息。

模块版本表示已发布的模块的不同更改集。例如，18.0 表示坐标为 com.google:guava:18.0 的模块版本。实际上，模块版本的方案没有限制。时间戳、数字和特殊后缀（如 -GA）都是允许的标识符。最广泛使用的版本控制策略是 语义版本控制。

平台是一组旨在一起使用的模块。平台有不同的类别，对应于不同的用例

Gradle 构建在插件系统之上。Gradle 本身主要由基础设施组成，例如，对于所有项目类型都复杂的依赖解析引擎。其余功能来自插件，包括与 Gradle 本身一起分发的“核心”插件、第三方插件以及给定构建中的脚本插件。

等效于插件，但编写方式使其看起来像构建脚本，预编译脚本插件可以使用 Groovy 或 Kotlin 编写，分别应用 groovy-gradle-plugin 或 kotlin-dsl 插件。

通常称为“模块”，每个 Gradle 项目都由 Project 实例支持，因此得名。

应该作为单个实体发布到仓库供使用者使用的文件和元数据的描述。

仓库托管一组模块，每个模块可以提供一个或多个由模块版本指示的发布（组件）。仓库可以基于二进制仓库产品（例如，Artifactory 或 Nexus）或文件系统中的目录结构。有关更多信息，请参阅声明仓库。

解析规则直接影响依赖的解析行为。解析规则被定义为构建逻辑的一部分。有关更多信息，请参阅关于直接自定义依赖解析的部分。

可以应用于其他 Gradle 脚本的 Gradle 脚本，包括构建脚本、settings 脚本和init 脚本。它可以使用 Groovy 或 Kotlin 编写，并通过 apply 方法应用于其他脚本。根据它们应用到的脚本类型，它们由Project 实例、Settings 实例或Gradle 实例支持。

settings.gradle(.kts) 脚本。Settings 脚本具有大量职责，但最重要的职责之一是通过 include :project 声明作为构建一部分的项目集。

每个项目由一个或多个任务组成。每个任务都应该是原子的（但通常不是），具有输入和输出。Gradle 执行任务以执行其工作。

组件的变体可能具有对其他模块的依赖才能正常工作，即所谓的传递依赖。托管在仓库上的模块发布可以提供元数据来声明这些传递依赖。默认情况下，Gradle 会自动解析传递依赖。传递依赖的版本选择可以通过声明依赖约束来影响。

每个组件由一个或多个变体组成。变体由一组产物组成，并定义一组依赖项。它由一组属性和能力标识。

属性用于标识和选择变体。变体定义了一个或多个属性，例如 org.gradle.usage=java-api、org.gradle.jvm.version=11。当解析依赖项时，会请求一组属性，Gradle 会为依赖图中的每个组件找到最合适的变体。可以为属性实现兼容性和消除歧义规则，以表达值之间的兼容性（例如，Java 8 与 Java 11 兼容，但如果请求的版本为 11 或更高版本，则应首选 Java 11）。此类规则通常由插件提供。有关更多信息，请参阅关于变体选择和声明属性的部分。