原生

內建模組，可支援原生規則和其他套件輔助函式。所有原生規則都會顯示為此模組中的函式，例如 native.cc_library。請注意，原生模組僅適用於載入階段 (即巨集，而非規則實作)。屬性會忽略 None 值，並將其視為未設定屬性。
您也可以使用下列函式：

成員

• existing_rule
• existing_rules
• exports_files
• glob
• module_name
• module_version
• package_group
• package_name
• package_relative_label
• repository_name
• subpackages

existing_rule

unknown native.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 標記，則會改為傳回具有相同內容的新可變動字典。

結果包含每個屬性的項目，但私人屬性 (名稱不以字母開頭) 和幾個無法表示的舊版屬性類型除外。此外，字典還包含規則例項的 name 和 kind 項目 (例如 'cc_binary')。

結果的值代表屬性值，如下所示：

• 屬性類型為 str、int 和 bool 時，會以原樣表示。
• 標籤會轉換為字串，如果是同一個套件中的目標，則為 ':foo' 格式；如果是不同套件中的目標，則為 '//pkg:name' 格式。
• 清單會以元組表示，字典會轉換為可變動的字典。其元素會以相同方式遞迴轉換。
• select 值會傳回，且內容會按照上述方式轉換。
• 在規則例項化期間未指定值，且系統計算出預設值的屬性，會從結果中排除。(計算的預設值必須在分析階段後才能計算)。

請盡量避免使用此函式。這會導致 BUILD 檔案變得脆弱且依序依賴。此外，請注意，這與將規則屬性值從內部格式轉換為 Starlark 的其他兩種轉換方式略有不同：一種是運算預設值使用，另一種是 ctx.attr.foo 使用。

參數

existing_rules

unknown native.existing_rules()

在此，不可變動的字典類型物件是指深層不可變動的物件 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)

參數

glob

sequence native.glob(include=[], exclude=[], exclude_directories=1, allow_empty=unbound)

• 至少符合 include 中的一個模式。
• 不符合 exclude 中的任何模式 (預設為 [])。

參數

module_name

string native.module_name()

module_version

string native.module_version()

package_group

None native.package_group(name, packages=[], includes=[])

參數

package_name

string native.package_name()

package_relative_label

Label native.package_relative_label(input)

這個函式只能在評估 BUILD 檔案和該檔案直接或間接呼叫的巨集時呼叫；例如，可能不會在規則實作函式中呼叫。

這個函式的結果與 Label 值相同，如果將指定字串傳遞至 BUILD 檔案中宣告的目標標籤值屬性，也會產生相同的結果。

使用說明：這個函式與 Label() 的差異在於，Label() 會使用呼叫它的 .bzl 檔案套件的背景資訊，而非 BUILD 檔案的套件。如需參照已硬式編碼至巨集中的固定目標 (例如編譯器)，請使用 Label()。如需將 BUILD 檔案提供的標籤字串標準化為 Label 物件，請使用 package_relative_label()。(除了 BUILD 檔案或呼叫的 .bzl 檔案，在套件內容中無法將字串轉換為 Label。因此，外部巨集應一律優先將 Label 物件傳遞至內部巨集，而非標籤字串。)

參數

repository_name

string native.repository_name()

子檔案包

sequence native.subpackages(include, exclude=[], allow_empty=False)

參數