WORKSPACE 文件

Nightly · 9.1 · 9.0 · 8.6 · 8.5 · 8.4 · 8.3 · 8.2 · 8.1
WORKSPACE 文件中提供的方法。

成员

绑定

None bind(name, actual=None)

已废弃：如需详细了解其问题和替代方案，请参阅考虑移除绑定。Bzlmod 中将不提供 bind()。

为 //external 软件包中的目标提供别名。

参数

参数 说明
name 字符串； 必需
“//external”下的标签，用作别名
actual 字符串；或 None； 默认值为 None
要别名的真实标签

register_execution_platforms

None register_execution_platforms(*platform_labels)

指定要注册的已定义执行平台。应为绝对目标模式（即以@或//开头）。如需了解详情，请参阅工具链解析。将扩展到多个目标的模式（例如:all）将按名称以字典顺序注册。

参数

参数 说明
platform_labels 字符串序列； 必需
要注册的目标模式。

register_toolchains

None register_toolchains(*toolchain_labels)

指定要注册的已定义工具链。应为绝对目标模式（即以@或//开头）。如需了解详情，请参阅工具链解析。将扩展到多个目标的模式（例如 :all）将按目标名称（而非工具链实现的名称）以字典顺序注册。

参数

参数 说明
toolchain_labels 字符串序列； 必需
要注册的目标模式。

工作区

None workspace(name)

此函数只能在 WORKSPACE 文件中使用，并且必须在 WORKSPACE 文件中的所有其他函数之前声明。每个 WORKSPACE 文件都应有一个 workspace 函数。

设置此工作区的名称。工作区名称应采用 Java 软件包样式的项目说明，使用下划线作为分隔符，例如 github.com/bazelbuild/bazel 应使用 com_github_bazelbuild_bazel。

此名称用于存储代码库运行文件的目录。例如，如果本地代码库中有一个运行文件 foo/bar，并且 WORKSPACE 文件包含 workspace(name = 'baz')，则该运行文件将位于 mytarget.runfiles/baz/foo/bar 下。如果未指定工作区名称，则该运行文件将符号链接到 bar.runfiles/foo/bar。

远程代码库规则名称必须是有效的工作区名称。例如，您可以拥有 maven_jar(name = 'foo')，但不能拥有 maven_jar(name = 'foo%bar')，因为 Bazel 会尝试为包含 workspace(name = 'foo%bar') 的 maven_jar 编写 WORKSPACE 文件。

参数

参数 说明
name 字符串； 必需
工作区的名称。名称必须以字母开头，并且只能包含字母、数字、下划线、短划线和英文句点。