WORKSPACE 文件

报告问题 每夜 build · 8.0 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

WORKSPACE 文件中提供的方法。

成员

绑定

None bind(name, actual=None)

警告:不建议使用 bind()。如需详细了解 bind 的问题和替代方案,请参阅考虑移除 bind

//external 软件包中的目标指定别名。

参数

参数 说明
name 必需
“//external”下的标签,用作别名名称
actual string;或 None; 默认为 None
要添加别名的真实标签

register_execution_platforms

None register_execution_platforms(*platform_labels)

注册已定义的平台,以便 Bazel 在工具链解析期间将其用作执行平台

参数

参数 说明
platform_labels 字符串序列; 必需
要注册的平台的标签。

register_toolchains

None register_toolchains(*toolchain_labels)

注册已定义的工具链,以便 Bazel 在工具链解析期间使用该工具链。请参阅定义注册工具链的示例。

参数

参数 说明
toolchain_labels 字符串序列; 必需
要注册的工具链的标签。标签可以包含 :all,在这种情况下,软件包中的所有提供工具链的目标将按名称按字典顺序注册。

工作区

None workspace(name)

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

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

此名称用于存储代码库运行文件的目录。例如,如果本地代码库中有 runfile foo/bar,并且 WORKSPACE 文件包含 workspace(name = 'baz'),则 runfile 将在 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 必填
工作区的名称。名称必须以字母开头,并且只能包含字母、数字、下划线、短划线和圆点。