原生

支援原生規則和其他套件輔助函式的內建模組。所有原生規則在本單元中會顯示為函式，例如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
• 子套件

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)