HTTP 存放區規則

此存放區的專屬名稱。

存放區目錄的相關目的地目錄。 將 `strip_prefix` (如有) 套用至封存檔內的檔案路徑後，封存檔就會解壓縮至這個目錄。舉例來說，如果 `add_prefix = "bar"` 和 `strip_prefix = "foo-1.2.3"`，檔案 `foo-1.2.3/src/foo.h` 就會解壓縮為 `bar/src/foo.h`。

選用字典，可將主機名稱對應至自訂授權模式。如果這個字典中包含網址的主機名稱，系統在產生 HTTP 要求的授權標頭時，就會使用該值做為模式。這可讓您使用許多常見雲端儲存空間供應商使用的自訂授權方案。這個模式目前支援 2 個符記：<login> 和 <password>，會在 netrc 檔案中針對相同主機名稱替換為等價值。格式化後，系統會將結果設為 HTTP 要求的 Authorization 欄位值。使用不記名憑證將 HTTP 下載內容下載到已啟用 OAuth 2 的 API 的範例屬性和 netrc：

auth_patterns = {
    "storage.cloudprovider.com": "Bearer <password>"
}

machine storage.cloudprovider.com
        password RANDOM-TOKEN

Authorization: Bearer RANDOM-TOKEN

這個檔案會用於做為此存放區的 BUILD 檔案。這個屬性是絕對標籤 (針對主存放區使用「@//」)。檔案名稱不必是 BUILD，但可以是 BUILD (例如 BUILD.new-repo-name，這樣可與存放區的實際 BUILD 檔案有所區別)。您可以指定 build_file 或 build_file_content，但不能同時指定。

這個存放區的 BUILD 檔案內容。您可以指定 build_file 或 build_file_content，但不能同時指定。

下載檔案的標準 ID。 如果指定的值非空白，Bazel 就不會從快取中取用檔案，除非檔案是透過具有相同標準 ID 的要求新增至快取。如果未指定或為空白，Bazel 預設會使用檔案的網址做為標準 ID。這有助於在不一併更新雜湊的情況下找出更新網址的常見錯誤，導致建構作業在本機成功，但在快取中沒有檔案的情況下會失敗。您可以使用 --repo_env=BAZEL_HTTP_RULES_URLS_AS_DEFAULT_CANONICAL_ID=0 停用這項行為。

下載檔案的預期總和檢查碼，格式為子資源完整性。這個 ID 必須與下載檔案的總和檢查碼相符。__由於遠端檔案可能會變更，因此省略總和檢查碼會帶來安全性風險。最好省略這個欄位會讓建構作業變得非密封。您可以選擇是否要使用此屬性來簡化開發作業，但應在發布前設定此屬性或 `sha256`。

用於驗證的 .netrc 檔案位置

提供給修補工具的引數。預設為 -p0，但 Git 產生的修補程式通常需要 -p1。如果指定多個 -p 引數，最後一個引數會生效。如果指定的引數不是 -p，Bazel 會改用修補指令列工具，而非 Bazel 原生修補實作。當改用修補命令列工具且未指定 patch_tool 屬性時，系統會使用 `patch`。這項設定只會影響 `patches` 屬性中的修補檔案。

套用修補程式後，在 Linux/Macos 上要套用的 Bash 指令序列。

套用修補程式後，要在 Windows 上套用的 Powershell 指令序列。如果未設定這項屬性，patch_cmds 會在 Windows 上執行，這需要 Bash 二進位檔存在。

要使用的 patch(1) 公用程式。如果指定此選項，Bazel 會使用指定的修補工具，而非 Bazel 原生修補實作。

擷取封存檔案後，要套用為修補程式的檔案清單。根據預設，它會使用 Bazel 原生修補程式實作，但不支援模糊比對和二進位修補程式，如果指定 `patch_tool` 屬性，或是 `patch_args` 屬性中有 `-p` 以外的引數，Bazel 就會改用修補指令列工具。

檔案相對路徑 (鍵) 與其完整性值 (值) 的對應。這些相對路徑應對應至「remote_file_urls」屬性中的檔案 (鍵)。

相對路徑 (鍵) 與網址清單 (值) 的對應項目，這些網址會下載並在原始碼集上提供做為重疊檔案。當您想在現有存放區上新增 WORKSPACE 或 BUILD.bazel 檔案時，這項功能就非常實用。系統會先下載檔案，再套用 `patches` 屬性中的修補程式，而網址清單應為相同檔案的可能鏡像。系統會依序嘗試這些網址，直到其中一個成功為止。

遠端修補程式中，要移除檔案名稱開頭的斜線數量。

修補檔案網址與其完整性值的對應，會在擷取封存檔後套用，然後再從 `patches` 屬性套用修補檔案之前套用。此工具使用 Bazel 原生修補程式實作項目，您可以使用「remote_patch_strip」來指定修補程式去除編號

從本機存放區名稱到全域存放區名稱的字典。如此一來，即可控管這個存放區的依附元件的工作區依附元件解決方案。

舉例來說，項目 `"@foo": "@bar"` 會宣告，每當這個存放區在任何情況下都依賴 `@foo` (例如對 `@foo//some:target` 上的依附元件)，實際上應在全域宣告的 `@bar` (`@bar//some:target`) 中解析該依附元件。

下載檔案的預期 SHA-256。這必須與下載檔案的 SHA-256 相符。_由於遠端檔案可能會變更，因此省略 SHA-256 會造成安全性風險。_即使省略這個欄位，也只能讓建構作業變得不完整。你可以選擇是否要在提交前設定這項屬性或「完整性」，藉此簡化開發作業。

要從解壓縮檔案中移除的目錄前置字串。許多封存檔都包含頂層目錄，內含封存檔中的所有實用檔案。這個欄位可用於從所有擷取的檔案中移除該前置字串，而不必在「build_file」中反覆指定這個前置字串。舉例來說，假設您使用的是 `foo-lib-latest.zip`，其中包含 `foo-lib-1.2.3/` 目錄，其中包含 `WORKSPACE` 檔案，以及 `src/`、`lib/` 和 `test/` 目錄，其中包含您要建構的實際程式碼。指定「strip_prefix = "foo-lib-1.2.3"」以使用「foo-lib-1.2.3」目錄做為頂層目錄。請注意，如果這個目錄之外有檔案，系統會捨棄這些檔案，且無法存取 (例如頂層授權檔案)。這包括開頭為前置字串的檔案/目錄，但不在目錄中 (例如`foo-lib-1.2.3.release-notes`)。如果指定的前置字串與封存檔中的目錄不符，Bazel 會傳回錯誤。

下載檔案的封存類型。根據預設，系統會根據網址的副檔名判斷封存檔類型。如果檔案沒有副檔名，您可以明確指定下列其中一項："zip"、`"jar"、`"war"、`"aar"、`"tar"`、`"tar.gz"、`"tgz"`、 `"tar.xz"`、"txz"、`tgz"、 `"tar.xz"`、"txz"、`"tar.zst"、`tar"z"。

可讓 Bazel 存取的檔案網址。 必須是檔案、http 或 https 網址。會遵循重新導向網址。不支援驗證。您可以使用 urls 參數指定要擷取的其他網址，藉此提高彈性。

要提供給 Bazel 的檔案網址清單。每個項目都必須是檔案、http 或 https 網址。會遵循重新導向網址。不支援驗證機制。 系統會依序嘗試各個網址，直到其中一個成功為止，因此應先列出本機鏡像。如果所有下載作業都失敗，則規則也會失敗。

要做為這個存放區「WORKSPACE」檔案使用的檔案。您可以指定 `workspace_file` 或 `workspace_file_content`，也可以兩者都不指定，但不能同時指定。

這個存放區的 WORKSPACE 檔案內容。您可以指定 `workspace_file` 或 `workspace_file_content`，也可以兩者都不指定，但不能同時指定。

這個存放區的專屬名稱。

選用字典，可將主機名稱對應至自訂授權模式。如果這個字典中包含網址的主機名稱，系統在產生 HTTP 要求的授權標頭時，就會使用該值做為模式。這可讓您使用許多常見雲端儲存空間供應商使用的自訂授權方案。這個模式目前支援 2 個符記：<login> 和 <password>，會在 netrc 檔案中針對相同主機名稱替換為等價值。格式化後，結果會設為 HTTP 要求的 Authorization 欄位值。使用不記名權杖以 http 下載至已啟用 OAuth2 的 API 屬性和 Netrc 範例：

auth_patterns = {
    "storage.cloudprovider.com": "Bearer <password>"
}

machine storage.cloudprovider.com
        password RANDOM-TOKEN

Authorization: Bearer RANDOM-TOKEN

下載檔案的標準 ID。 如果指定的值非空白，Bazel 就不會從快取中取用檔案，除非檔案是透過具有相同標準 ID 的要求新增至快取。如果未指定或為空白，Bazel 預設會使用檔案的網址做為標準 ID。這有助於在不一併更新雜湊的情況下找出更新網址的常見錯誤，導致建構作業在本機成功，但在快取中沒有檔案的情況下會失敗。您可以使用 --repo_env=BAZEL_HTTP_RULES_URLS_AS_DEFAULT_CANONICAL_ID=0 停用這項行為。

指派給下載檔案的路徑

是否應將下載的檔案設為可執行。

下載檔案的預期總和檢查碼，格式為子資源完整性。這個 ID 必須與下載檔案的總和檢查碼相符。__由於遠端檔案可能會變更，因此省略總和檢查碼會帶來安全性風險。最好省略這個欄位會讓建構作業變得非密封。您可以選擇是否要使用此屬性來簡化開發作業，但應在發布前設定此屬性或 `sha256`。

用於驗證的 .netrc 檔案位置

從本機存放區名稱到全域存放區名稱的字典。這樣就能控管此存放區依附元件的依附元件解析工作區。

舉例來說，項目 `"@foo": "@bar"` 會宣告，每當這個存放區在任何情況下都依賴 `@foo` (例如對 `@foo//some:target` 上的依附元件)，實際上應在全域宣告的 `@bar` (`@bar//some:target`) 中解析該依附元件。

下載檔案的預期 SHA-256。 這必須與下載檔案的 SHA-256 相符。_由於遠端檔案可能會變更，因此省略 SHA-256 會造成安全性風險。_即使省略這個欄位，也只能讓建構作業變得不完整。您可以選擇是否要設定這個值，以利開發作業，但應在發布前設定。

可讓 Bazel 存取的檔案網址。 必須是檔案、http 或 https 網址。會遵循重新導向網址。不支援驗證。您可以使用 urls 參數指定要擷取的其他網址，藉此提高彈性。

要提供給 Bazel 的檔案網址清單。每個項目都必須是檔案、http 或 https 網址。會遵循重新導向網址。不支援驗證。系統會依序嘗試各個網址，直到其中一個成功為止，因此應先列出本機鏡像。如果所有下載作業都失敗，則規則也會失敗。

此存放區的專屬名稱。

選用字典，可將主機名稱對應至自訂授權模式。如果這個字典中包含網址的主機名稱，系統在產生 HTTP 要求的授權標頭時，就會使用該值做為模式。這可讓您使用許多常見雲端儲存空間供應商使用的自訂授權方案。這個模式目前支援 2 個符記：<login> 和 <password>。這兩種符記會替換為相同主機名稱 netrc 檔案中的對等值。格式化後，系統會將結果設為 HTTP 要求的 Authorization 欄位值。使用不記名權杖以 http 下載至已啟用 OAuth2 的 API 屬性和 Netrc 範例：

auth_patterns = {
    "storage.cloudprovider.com": "Bearer <password>"
}

machine storage.cloudprovider.com
        password RANDOM-TOKEN

Authorization: Bearer RANDOM-TOKEN

下載檔案的標準 ID。 如果指定的值非空白，Bazel 就不會從快取中取用檔案，除非檔案是透過具有相同標準 ID 的要求新增至快取。如果未指定或為空白，Bazel 預設會使用檔案的網址做為標準 ID。這有助於在不一併更新雜湊的情況下找出更新網址的常見錯誤，導致建構作業在本機成功，但在快取中沒有檔案的情況下會失敗。您可以使用 --repo_env=BAZEL_HTTP_RULES_URLS_AS_DEFAULT_CANONICAL_ID=0 停用這項行為。

指派給已下載 jar 的檔案名稱

下載檔案的預期總和檢查碼，格式為子資源完整性。這個 ID 必須與下載檔案的總和檢查碼相符。__由於遠端檔案可能會變更，因此省略總和檢查碼會帶來安全性風險。最好省略這個欄位會讓建構作業變得非密封。您可以選擇是否要使用此屬性來簡化開發作業，但應在發布前設定此屬性或 `sha256`。

用於驗證的 .netrc 檔案位置

從本機存放區名稱到全域存放區名稱的字典。如此一來，即可控管這個存放區的依附元件的工作區依附元件解決方案。

舉例來說，項目 `"@foo": "@bar"` 會宣告，每當這個存放區在任何情況下都依賴 `@foo` (例如對 `@foo//some:target` 上的依附元件)，實際上應在全域宣告的 `@bar` (`@bar//some:target`) 中解析該依附元件。

下載檔案的預期 SHA-256。這必須與下載檔案的 SHA-256 相符。_由於遠端檔案可能會變更，因此省略 SHA-256 會造成安全性風險。_即使省略這個欄位，也只能讓建構作業變得不完整。你可以選擇是否要在提交前設定這項屬性或「完整性」，藉此簡化開發作業。

可讓 Bazel 存取的檔案網址。 必須是檔案、http 或 https 網址。我們會遵循路線指示。 不支援驗證。您可以使用 urls 參數指定要擷取的其他網址，藉此提高彈性。網址結尾必須是 `.jar`。

可讓 Bazel 存取的檔案網址清單。 每個項目都必須是檔案、http 或 https 網址。我們會遵循路線指示。 不支援驗證。系統會依序嘗試各個網址，直到其中一個成功為止，因此應先列出本機鏡像。如果所有下載作業都失敗，則規則也會失敗。所有網址都必須以 `.jar` 結尾。