內建模組，可支援原生規則和其他套件輔助函式。所有原生規則都會顯示為此模組中的函式，例如 native.cc_library。請注意，原生模組只能在載入階段中使用 (例如巨集，不適用於規則導入)。屬性會忽略 None 值，並將其視為未設定的屬性。
您還可以使用下列函式：
成員
- existing_rule
- existing_rules
- exports_files
- glob
- module_name
- module_version
- package_group
- package_name
- package_relative_label
- repository_name
- 子套件
existing_rule
unknown native.existing_rule(name)傳回不可變動的字典類物件，用於描述在這個執行緒套件中例項化的規則屬性，如果沒有該名稱的規則例項，則傳回
None。在此，不可變動的字典類型物件是指深層不可變動的物件 x，可支援字典類型的疊代作業、len(x)、name in x、x[name]、x.get(name)、x.items()、x.keys() 和 x.values()。
如果已設定 --noincompatible_existing_rules_immutable_view 標記，系統會改為傳回具有相同內容的新可變動字典。
結果包含每個屬性的項目，但私人屬性 (名稱開頭不是英文字母) 和幾個無法表示的舊版屬性類型除外。此外，字典中包含規則例項的 name 和 kind (例如 'cc_binary') 項目。
結果的值代表屬性值，如下所示：
- 屬性類型為 str、int 和 bool 的屬性會以原樣表示。
- 針對同一套件中的目標，標籤會轉換為
':foo'形式的字串，對於其他套件中的目標，則會轉換為'//pkg:name'形式的字串。 - 清單會以元組表示，字典會轉換為可變動的字典。其元素會以相同方式遞迴轉換。
select值會傳回，且內容會按照上述方式轉換。- 在規則例項化期間未指定值，且系統計算出預設值的屬性，會從結果中排除。(直到分析階段才能計算運算預設值)。
請盡量避免使用這個函式。這會導致 BUILD 檔案變得脆弱且依序依賴。另請注意，這與內部形式至 Starlark 的兩種規則屬性值有細微差異：運算預設值使用，另一個用於 ctx.attr.foo。
參數
| 參數 | 說明 |
|---|---|
name
|
required 目標名稱。 |
existing_rules
unknown native.existing_rules()傳回不可變動的字典類型物件，描述目前在這個執行緒套件中已例項化的規則。每個類似 dict 物件的項目會將規則執行個體的名稱對應到
existing_rule(name) 傳回的結果。在此，不可變動的字典類型物件是指深層不可變動的物件 x，可支援字典類型的疊代作業、len(x)、name in x、x[name]、x.get(name)、x.items()、x.keys() 和 x.values()。
如果設定 --noincompatible_existing_rules_immutable_view 標記，則會改為傳回具有相同內容的新可變動字典。
注意：請盡量避免使用這個函式。這會導致 BUILD 檔案變得脆弱且依序依賴。此外，如果設定 --noincompatible_existing_rules_immutable_view 旗標，此函式的成本可能相當高昂，尤其是在迴圈內呼叫時。
exports_files
None native.exports_files(srcs, visibility=None, licenses=None)參數
| 參數 | 說明 |
|---|---|
srcs
|
字串序列；
必要 The list of files to export. |
visibility
|
sequence；或 None；預設為 None您可以指定可見度宣告。指定的目標將可看到這些檔案。如未指定瀏覽權限，每個套件都能看到檔案。 |
licenses
|
字串的序列；或 None；
預設值為 None需要指定的授權。 |
Glob
sequence native.glob(include=[], exclude=[], exclude_directories=1, allow_empty=unbound)Glob 會傳回目前套件中每個檔案的可變動清單清單，且之排序如下：
- 至少符合
include中的一個模式。 - 不符合
exclude中的任何模式 (預設為[])。
exclude_directories 引數 (設為 1)，結果會省略類型目錄的檔案 (預設值為 1)。
參數
| 參數 | 說明 |
|---|---|
include
|
字串的序列；
預設值為 []要納入的 glob 模式清單。 |
exclude
|
字串的序列；預設為 []。 您要排除的 glob 模式清單。 |
exclude_directories
|
預設值為 1旗標是否要排除目錄。 |
allow_empty
|
預設值為 unbound我們是否允許 glob 模式比對任何內容。如果「allow_empty」為 False，每個個別 include 模式都必須相符，且最終結果也必須為非空白 (排除「Exclude」模式的相符結果後)。 |
module_name
string native.module_name()與這個套件的存放區相關聯的 Bazel 模組名稱。如果這個套件來自 WORKSPACE 中定義的存放區，而非 MODULE.bazel，這裡會是空的。如果是模組擴充功能產生的 repo，則為代管擴充功能的模組名稱。與
module_ctx.modules 中顯示的 module.name 欄位相同。
可能會傳回 None。
module_version
string native.module_version()與這個套件相關聯的存放區相關聯的 Bazel 模組版本。如果這個套件來自 WORKSPACE 中定義的存放區，而非 MODULE.bazel，則這個值會是空白。對於由模組擴充功能產生的存放區，這是代管擴充功能的模組版本。與
module_ctx.modules 中顯示的 module.version 欄位相同。
可能會傳回 None。
package_group
None native.package_group(name, packages=[], includes=[])visibility 屬性中參照這個標籤。
參數
| 參數 | 說明 |
|---|---|
name
|
必要 這項規則的專屬名稱。 |
packages
|
字串的序列；
預設值為 []此群組中套件的完整列舉。 |
includes
|
字串的序列；預設為 []。 此套件中包含的其他套件群組。 |
package_name
string native.package_name()要評估的套件名稱。舉例來說，在 BUILD 檔案
some/package/BUILD 中，其值會是 some/package。如果 BUILD 檔案呼叫了 .bzl 檔案中定義的函式，package_name() 會與呼叫端的 BUILD 檔案套件相符。此函式相當於已淘汰的變數 PACKAGE_NAME。
package_relative_label
Label native.package_relative_label(input)根據目前初始化的套件 (也就是執行目前巨集的
BUILD 檔案)，將輸入字串轉換為 Label 物件。如果輸入內容已是 Label，則會以原樣傳回。只有在評估 BUILD 檔案及其直接或間接呼叫時，才能呼叫此函式。可能不會 (例如) 規則實作函式呼叫。
這個函式的結果與 Label 值相同，如果將指定字串傳遞至 BUILD 檔案中宣告的目標標籤值屬性，也會產生相同的結果。
使用注意事項：這個函式與 Label() 的差異，在於 Label() 使用呼叫該檔案的 .bzl 檔案套件的內容，而非 BUILD 檔案的套件。如需參照已硬式編碼至巨集中的固定目標 (例如編譯器)，請使用 Label()。當您需要將 BUILD 檔案提供的標籤字串正規化為 Label 物件時，請使用 package_relative_label()。(除了 BUILD 檔案或呼叫的 .bzl 檔案，在套件內容中無法將字串轉換為 Label。因此，外部巨集最好一律將標籤物件傳遞至內部巨集，而不是標籤字串)。
參數
| 參數 | 說明 |
|---|---|
input
|
字串或 Label；
必填 Label 輸入字串或 Label 物件。如果傳遞 Label 物件，系統會依原樣傳回該物件。 |
repository_name
string native.repository_name()用於呼叫規則或建構擴充功能的存放區名稱。舉例來說，WORKSPACE 群組
local_repository(name='local', path=...) 呼叫的套件中已存在，該套件會設為 @local。在主要存放區的套件中，會設為 @。這個函式與已淘汰的變數 REPOSITORY_NAME 等同。子套件
sequence native.subpackages(include, exclude=[], allow_empty=False)傳回目前套件的每個直接子包的新可變動清單，不受檔案系統目錄深度影響。傳回的清單經過排序，且包含與目前套件相關的子套件名稱。建議您優先使用 bazel_skylib.subpackages 模組中的方法，不要直接呼叫這個函式。
參數
| 參數 | 說明 |
|---|---|
include
|
字串的序列；
必要 要納入子套件掃描作業的 glob 模式清單。 |
exclude
|
字串的序列；
預設值為 []要從子套件掃描作業中排除的 glob 模式清單。 |
allow_empty
|
預設值為 False指出呼叫傳回空白清單時是否會失敗。根據預設，空白清單代表 BUILD 檔案中的潛在錯誤，其中呼叫 subpackages() 非常嚴重。如果設為 true，這個函式將可成功執行。 |