內建模組,可支援原生規則和其他套件輔助函式。所有原生規則都會顯示為此模組中的函式,例如 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,這個函式將可成功執行。 |