原生

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

成員

• existing_rule
• existing_rules
• exports_files
• glob
• module_name
• module_version
• package_group
• package_name
• package_relative_label
• repo_name
• 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()。

結果包含每個屬性的項目，但私人屬性 (名稱不以字母開頭) 和幾個無法表示的舊版屬性類型除外。此外，字典還包含規則例項的 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()。

注意：請盡量避免使用這個函式。這會導致 BUILD 檔案變得脆弱且依序依賴。

exports_files

None native.exports_files(srcs, visibility=None, licenses=None)

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

string native.module_name()

string native.module_version()

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

string native.package_name()

Label native.package_relative_label(input)

string native.repo_name()

string native.repository_name()

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