词汇表

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

构建是 Gradle 执行的原子工作单元的聚合。它由项目组成，这些项目包含一组任务。

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

一个 build.gradle 脚本。

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

模块的任一单一版本。

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

配置是按特定目标分组的一组已命名的依赖项。配置提供对底层已解析模块及其 artifacts 的访问。更多信息，请参见关于依赖配置以及可解析和可消费配置的章节。

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}")
    }
}

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

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

许多 Gradle API 有两种形式：eager 和 lazy。区别在于何时计算或解析值。

// Eager: evaluated as soon as the build script runs
val myValue = file("output.txt")
// Lazy: evaluated only when required
val myValue = layout.buildDirectory.file("output.txt")

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

Gradle 构建的第二个主要阶段，执行阶段在配置阶段完成后发生。在这个阶段，所有任务动作都会被执行。

特征变体是代表组件可单独选择的功能的变体。特征变体由一个或多个能力标识。更多信息，请参见关于建模特征变体和可选依赖项的章节。

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

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

初始化脚本由 Gradle 类型的一个实例支持。

许多 Gradle API 有两种形式：eager 和 lazy。区别在于何时计算或解析值。

// Lazy: evaluated only when required
val myValue = layout.buildDirectory.file("output.txt")
// Eager: evaluated as soon as the build script runs
val myValue = file("output.txt")

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

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

模块的发布版提供元数据。元数据是更详细描述模块的数据，例如关于 artifacts 位置或所需传递性依赖项的信息。Gradle 提供自己的元数据格式，称为Gradle Module Metadata (.module 文件)，但也支持 Maven (.pom) 和 Ivy (ivy.xml) 元数据。更多关于支持的元数据格式的信息，请参见关于理解 Gradle Module Metadata的章节。

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

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

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

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

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

关于文件和元数据（应作为一个单一实体发布到仓库供消费者使用）的描述。

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

解析规则直接影响依赖项的解析行为。解析规则作为构建逻辑的一部分定义。更多信息，请参见关于直接定制依赖项解析的章节。

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

一个 settings.gradle(.kts) 脚本。settings 脚本有许多职责，但其中最重要的一项是通过 include :project 声明构成构建的项目集合。

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

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

每个组件包含一个或多个变体。变体包含一组 artifacts 并定义一组依赖项。它由一组属性和能力标识。

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