Gradle 公開 API 以宣告儲存庫可能包含或不包含的內容。它有不同的使用案例

  • 效能 當您知道永遠不會在特定儲存庫中找到相依性時

  • 安全性 藉由避免洩漏在私人專案中使用的相依性

  • 可靠性 當某些儲存庫包含無效或不正確的中繼資料或成品時

當考慮到宣告的儲存庫順序很重要時，這甚至更重要。

宣告儲存庫篩選器

build.gradle.kts
repositories {
    maven {
        url = uri("https://repo.mycompany.com/maven2")
        content {
            // this repository *only* contains artifacts with group "my.company"
            includeGroup("my.company")
        }
    }
    mavenCentral {
        content {
            // this repository contains everything BUT artifacts with group starting with "my.company"
            excludeGroupByRegex("my\\.company.*")
        }
    }
}
build.gradle
repositories {
    maven {
        url = "https://repo.mycompany.com/maven2"
        content {
            // this repository *only* contains artifacts with group "my.company"
            includeGroup "my.company"
        }
    }
    mavenCentral {
        content {
            // this repository contains everything BUT artifacts with group starting with "my.company"
            excludeGroupByRegex "my\\.company.*"
        }
    }
}

預設情況下，儲存庫包含所有內容，不排除任何內容

  • 如果您宣告 include，則它會排除所有內容，但包含的內容除外。

  • 如果您宣告 exclude，則它會包含所有內容，但排除的內容除外。

  • 如果您同時宣告 includes 和 excludes，則它只包含明確包含且未排除的內容。

可以依明確的群組、模組或版本，嚴格地或使用正則表達式進行篩選。使用嚴格版本時，可以使用版本範圍，使用 Gradle 支援的格式。此外，還有依解析上下文的篩選選項：配置名稱甚至配置屬性。請參閱 RepositoryContentDescriptor 以取得詳細資訊。

宣告在一個儲存庫中獨家找到的內容

使用儲存庫層級內容篩選器宣告的篩選器不是獨家的。這表示宣告儲存庫包含成品並不表示其他儲存庫也不能擁有它：您必須宣告每個儲存庫在擴充中包含的內容。

或者，Gradle 提供 API，讓您宣告儲存庫獨家包含成品。如果您這樣做

  • 在儲存庫中宣告的成品無法在任何其他儲存庫中找到

  • 獨家儲存庫內容必須在擴充中宣告（就像儲存庫層級內容一樣）

build.gradle.kts
repositories {
    // This repository will _not_ be searched for artifacts in my.company
    // despite being declared first
    mavenCentral()
    exclusiveContent {
        forRepository {
            maven {
                url = uri("https://repo.mycompany.com/maven2")
            }
        }
        filter {
            // this repository *only* contains artifacts with group "my.company"
            includeGroup("my.company")
        }
    }
}
build.gradle
repositories {
    // This repository will _not_ be searched for artifacts in my.company
    // despite being declared first
    mavenCentral()
    exclusiveContent {
        forRepository {
            maven {
                url = "https://repo.mycompany.com/maven2"
            }
        }
        filter {
            // this repository *only* contains artifacts with group "my.company"
            includeGroup "my.company"
        }
    }
}

可以依明確的群組、模組或版本，嚴格地或使用正則表達式進行篩選。請參閱 InclusiveRepositoryContentDescriptor 以取得詳細資訊。

如果您在 settings.gradle(.kts)的pluginManagement區段中利用獨家內容篩選，則透過專案 buildscript.repositories 新增更多儲存庫將是非法的。在這種情況下，建置配置將會失敗。

您的選項是在設定中宣告所有儲存庫，或使用非獨家內容篩選。

Maven 儲存庫篩選

對於Maven 儲存庫，通常情況是儲存庫將包含發行版本或快照。Gradle 讓您可以使用此 DSL 宣告在儲存庫中找到哪種成品

build.gradle.kts
repositories {
    maven {
        url = uri("https://repo.mycompany.com/releases")
        mavenContent {
            releasesOnly()
        }
    }
    maven {
        url = uri("https://repo.mycompany.com/snapshots")
        mavenContent {
            snapshotsOnly()
        }
    }
}
build.gradle
repositories {
    maven {
        url = "https://repo.mycompany.com/releases"
        mavenContent {
            releasesOnly()
        }
    }
    maven {
        url = "https://repo.mycompany.com/snapshots"
        mavenContent {
            snapshotsOnly()
        }
    }
}