詞彙表

建置產生的檔案或目錄，例如 JAR、ZIP 發行版本或原生可執行檔。

建置是 Gradle 執行的原子工作片段的總和。它由專案組成，而這些專案又有一系列任務。

建置掃描是 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 腳本，包括建置腳本、設定腳本和init 腳本。它可以使用 Groovy 或 Kotlin 編寫，並透過 apply 方法套用至其他腳本。根據套用腳本的類型，它們由Project 實例、Settings 實例或 Gradle 實例支援。

settings.gradle(.kts) 腳本。設定腳本有很多職責，但最重要的職責之一是透過 include :project 宣告屬於建置一部分的專案集合。

每個專案都由一個或多個任務組成。每個任務都應該是原子的（但通常不是），具有輸入和輸出。Gradle 執行任務以執行其工作。

組件的變體可能具有對其他模組的相依性才能正常工作，即所謂的傳遞相依性。託管在儲存庫上的模組發行版本可以提供中繼資料來宣告這些傳遞相依性。預設情況下，Gradle 會自動解析傳遞相依性。傳遞相依性的版本選擇可以透過宣告相依性約束來影響。

每個組件都由一個或多個變體組成。變體由一組成品組成，並定義一組相依性。它由一組屬性和功能識別。

屬性用於識別和選擇變體。變體定義了一個或多個屬性，例如 org.gradle.usage=java-api、org.gradle.jvm.version=11。當解析相依性時，會請求一組屬性，並且 Gradle 會為相依性圖中的每個組件找到最適合的變體。相容性和消除歧義規則可以針對屬性實作，以表示值之間的相容性（例如，Java 8 與 Java 11 相容，但如果請求的版本為 11 或更高版本，則應優先選擇 Java 11）。此類規則通常由外掛程式提供。如需更多資訊，請參閱關於變體選擇和宣告屬性的章節。