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)
None。在此处，不可变的类字典对象是指支持类字典迭代、len(x)、name in x、x[name]、x.get(name)、x.items()、x.keys() 和 x.values() 的深度不可变对象 x。
结果包含每个属性的条目，但名称不以字母开头的私有属性和一些无法表示的旧版属性类型除外。此外，该字典还包含规则实例的 name 和 kind（例如 'cc_binary'）的条目。
结果的值表示属性值，如下所示：
- 类型为 str、int 和 bool 的属性按原样表示。
- 标签会转换为
':foo'形式的字符串（对于同一软件包中的目标）或'//pkg:name'形式的字符串（对于不同软件包中的目标）。 - 列表表示为元组，字典转换为新的可变字典。它们的元素会以相同的方式递归转换。
- 系统会返回
select值，但其内容会按上述方式进行转换。 - 在规则实例化期间未指定值且默认值是计算得出的属性会被排除在结果之外。（在分析阶段之前，无法计算计算出的默认值）。
如果可能，请避免使用此函数。这会导致 BUILD 文件变得脆弱且依赖于顺序。另请注意，它与另外两种将规则属性值从内部形式转换为 Starlark 的转换略有不同：一种用于计算出的默认值，另一种用于 ctx.attr.foo。
参数
| 参数 | 说明 |
|---|---|
name
|
字符串；
必需 目标的名称。 |
existing_rules
unknown native.existing_rules()
existing_rule(name) 将返回的结果。在此处，不可变的类字典对象是指支持类字典迭代、len(x)、name in x、x[name]、x.get(name)、x.items()、x.keys() 和 x.values() 的深度不可变对象 x。
注意：如果可能，请避免使用此函数。这会使 BUILD 文件变得脆弱且依赖于顺序。
exports_files
None native.exports_files(srcs, visibility=None, licenses=None)参数
| 参数 | 说明 |
|---|---|
srcs
|
字符串的序列；必需 要导出的文件列表。 |
visibility
|
序列；或 None；
默认值为 None可以指定可见性声明。指定的目标可以查看这些文件。如果未指定任何可见性，则文件对每个软件包都可见。 |
licenses
|
字符串的序列；或 None；
默认值为 None要指定的许可。 |
glob
sequence native.glob(include=[], exclude=[], exclude_directories=1, allow_empty=unbound)
- 匹配
include中的至少一种模式。 - 与
exclude中的任何格式都不匹配（默认值为[]）。
exclude_directories 实参（设置为 1），结果中将省略目录类型的文件（默认值为 1）。
参数
| 参数 | 说明 |
|---|---|
include
|
字符串的序列；默认值为 []要包含的 glob 模式的列表。 |
exclude
|
字符串的序列；默认值为 []要排除的 glob 模式列表。 |
exclude_directories
|
int；
默认值为 1一个标志，用于指示是否排除目录。 |
allow_empty
|
默认值为 unbound是否允许 glob 模式不匹配任何内容。如果 `allow_empty` 为 False，则每个单独的包含模式都必须匹配某些内容，并且最终结果必须为非空（在排除 `exclude` 模式的匹配项之后）。 |
module_name
string native.module_name()
module_ctx.modules 中显示的 module.name 字段相同。
可能会返回 None。
module_version
string native.module_version()
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()
some/package/BUILD 中，其值将为 some/package。如果 BUILD 文件调用了 .bzl 文件中定义的函数，则 package_name() 将与调用方 BUILD 文件软件包匹配。
package_relative_label
Label native.package_relative_label(input)
BUILD 文件）的上下文中，将输入字符串转换为 Label 对象。如果输入已经是 Label，则返回时不会进行任何更改。此函数只能在评估 BUILD 文件及其直接或间接调用的宏时调用；不能在规则实现函数（例如）中调用。
此函数的结果与将给定字符串传递给 BUILD 文件中声明的目标的标签值属性所产生的结果相同，均为 Label 值。
使用说明：此函数与 Label() 的区别在于，Label() 使用的是调用它的 .bzl 文件的软件包上下文，而不是 BUILD 文件的软件包上下文。当您需要引用硬编码到宏中的固定目标（例如编译器）时，请使用 Label()。当您需要将 BUILD 文件提供的标签字符串标准化为 Label 对象时，请使用 package_relative_label()。（在 BUILD 文件或调用的 .bzl 文件之外的软件包上下文中，无法将字符串转换为 Label。因此，外部宏应始终优先将 Label 对象传递给内部宏，而不是标签字符串。）
参数
| 参数 | 说明 |
|---|---|
input
|
string；或 Label；必需 输入标签字符串或 Label 对象。如果传递的是 Label 对象，则按原样返回。 |
repo_name
string native.repo_name()
repository_name
string native.repository_name()
--+incompatible_enable_deprecated_label_apis 设置为 来以实验性方式启用该功能。已弃用。建议改用
repo_name，该方法不包含虚假的前导 @ 符号，但在其他方面行为相同。包含当前正在评估的软件包的仓库的规范名称，以单个英文艾特符 (@) 为前缀。例如，在由 WORKSPACE stanza local_repository(name='local', path=...) 调用而创建的软件包中，它将设置为 @local。在主代码库中的软件包中，它将设置为 @。
子软件包
sequence native.subpackages(include, exclude=[], allow_empty=False)
参数
| 参数 | 说明 |
|---|---|
include
|
字符串的序列；必需 要在子软件包扫描中包含的 glob 模式列表。 |
exclude
|
字符串的序列；
默认值为 []要从子软件包扫描中排除的 glob 模式列表。 |
allow_empty
|
bool;
default is FalseWhether we fail if the call returns an empty list. 默认情况下，空列表表示 BUILD 文件中可能存在错误，其中对 subpackages() 的调用是多余的。设置为 true 可让此函数在这种情况下成功运行。 |