MODULE.bazel 文件

<ph type="x-smartling-placeholder"></ph> 报告问题 敬上 每晚 · 7.3。 · 7.2 条 · 7.1。 · 7.0。 · 6.5

MODULE.bazel 文件中提供的方法。

成员

archive_override

None archive_override(module_name, urls, integrity='', strip_prefix='', patches=[], patch_cmds=[], patch_strip=0)

指定此依赖项应来自特定位置的归档文件(zip、gzip 等),而不是来自注册表。此指令仅在根模块中有效;换句话说,如果某个模块被其他模块用作依赖项,则其自己的替换项会被忽略。

参数

参数 说明
module_name string; 必需
要应用此替换项的 Bazel 模块依赖项的名称。
urls string;或 string 的 Iterable; 必需
归档的网址;可以是 http(s):// 或 file:// 网址。
integrity string; 默认值为 ''
归档文件的预期校验和,采用子资源完整性格式。
strip_prefix string; 默认值为 ''
要从提取的文件中删除的目录前缀。
patches 字符串可迭代; 默认值为 []
指向要应用于此模块的补丁文件的标签列表。补丁文件必须存在于顶级项目的源代码树中。它们按列表顺序应用。
patch_cmds 字符串可迭代; 默认值为 []
应用补丁后,要应用于 Linux/Macos 的一系列 Bash 命令。
patch_strip int; 默认值为 0
与 Unix 补丁的 --strip 参数相同。

bazel_dep

None bazel_dep(name, version='', max_compatibility_level=-1, repo_name='', dev_dependency=False)

声明对另一个 Bazel 模块的直接依赖项。

参数

参数 说明
name string; 必需
要作为直接依赖项添加的模块的名称。
version string; 默认值为 ''
要作为直接依赖项添加的模块的版本。
max_compatibility_level int; 默认值为 -1
支持将模块添加为直接依赖项的最大 compatibility_level。模块的版本暗含了支持的最低兼容性级别以及未指定此属性的最高级别。
repo_name string; 默认值为 ''
表示此依赖项的外部代码库的名称。默认情况下,这是模块的名称。
dev_dependency bool; 默认值为 False
如果为 true,如果当前模块不是根模块或已启用 `--ignore_dev_dependency`,系统会忽略此依赖项。

git_override

None git_override(module_name, remote, commit='', patches=[], patch_cmds=[], patch_strip=0, init_submodules=False, strip_prefix='')

指定依赖项应来自 Git 代码库的特定提交。此指令仅在根模块中有效;换句话说,如果某个模块被其他模块用作依赖项,则其自己的替换项会被忽略。

参数

参数 说明
module_name string; 必需
要应用此替换项的 Bazel 模块依赖项的名称。
remote string; 必需
远程 Git 代码库的网址。
commit string; 默认值为 ''
应签出的提交。
patches 字符串可迭代; 默认值为 []
指向要应用于此模块的补丁文件的标签列表。补丁文件必须存在于顶级项目的源代码树中。它们按列表顺序应用。
patch_cmds 字符串可迭代; 默认值为 []
应用补丁后,要应用于 Linux/Macos 的一系列 Bash 命令。
patch_strip int; 默认值为 0
与 Unix 补丁的 --strip 参数相同。
init_submodules bool; 默认值为 False
所提取代码库中的 Git 子模块是否应以递归方式初始化。
strip_prefix string; 默认值为 ''
要从提取的文件中删除的目录前缀。这可用于以 Git 代码库的子目录为目标。请注意,子目录必须具有自己的“MODULE.bazel”文件,其模块名称与传递到此“git_override”的“module_name”参数相同。

包含

None include(label)

包含另一个类似 MODULE.bazel 的文件的内容。实际上,include() 的行为就好像包含的文件以文本形式放置在 include() 调用的位置一样,只不过变量绑定(例如用于 use_extension 的绑定)始终仅在出现它们的文件中可见,而不会在任何包含或包含的文件中可见。

只有根模块可以使用 include();如果 bazel_dep 的 MODULE 文件使用 include(),则会发生错误。

只能包含主代码库中的文件。

借助 include(),您可以将根模块文件分割为多个部分,以避免拥有庞大的 MODULE.bazel 文件,或更好地管理各个语义段的访问权限控制。

参数

参数 说明
label string; 必需
指向要包含的文件的标签。该标签必须指向主代码库中的文件;也就是说,它必须以双斜线 (//) 开头。

local_path_override

None local_path_override(module_name, path)

指定依赖项应来自本地磁盘上的特定目录。此指令仅在根模块中有效;换句话说,如果某个模块被其他模块用作依赖项,则其自己的替换项会被忽略。

参数

参数 说明
module_name string; 必需
要应用此替换项的 Bazel 模块依赖项的名称。
path string; 必需
此模块所在目录的路径。

module

None module(name='', version='', compatibility_level=0, repo_name='', bazel_compatibility=[])

声明当前 Bazel 代码库表示的 Bazel 模块的某些属性。这些属性要么是模块的基本元数据(例如名称和版本),要么会影响当前模块及其依赖项的行为。

最多只能调用一次它,如果调用,它必须是 MODULE.bazel 文件中的第一个指令。仅当此模块是根模块(例如,不被其他模块依赖)时,才能省略它。

参数

参数 说明
name string; 默认值为 ''
模块的名称。仅当此模块是根模块(例如,不被其他模块依赖)时,才能省略。有效的模块名称必须:1) 只能包含小写字母 (a-z)、数字 (0-9)、点 (.)、连字符 (-) 和下划线 (_);2) 以小写字母开头;3) 以小写字母或数字结尾。
version string; 默认值为 ''
模块的版本。仅当此模块是根模块(例如,不被其他模块依赖)时,才能省略。版本必须采用宽松的 SemVer 格式;如需了解详情,请参阅相关文档
compatibility_level int; 默认值为 0
模块的兼容性级别;每次引入不兼容的重大更改时,都应更改此名称。这基本上就是SemVer 的相同之处,只不过它并未嵌入版本字符串本身,而是作为单独的字段存在。具有不同兼容性级别的模块会参与版本解析,就像它们是具有不同名称的模块一样,但最终的依赖关系图不能包含名称相同但兼容性级别不同的多个模块(除非 multiple_version_override 有效)。如需了解详情,请参阅相关文档
repo_name string; 默认值为 ''
表示此模块的代码库的名称,如模块本身所示。默认情况下,代码库的名称是模块的名称。如果项目一直使用与其模块名称不同的代码库名称,则可以指定此属性,以简化迁移过程。
bazel_compatibility 字符串可迭代; 默认值为 []
一个 Bazel 版本列表,允许用户声明哪些 Bazel 版本与此模块兼容。这不会影响依赖项解析,但 bzlmod 将使用此信息来检查当前的 Bazel 版本是否兼容。此值的格式为以英文逗号分隔的一些限制条件值的字符串。支持三个限制条件:<=X.X.X:Bazel 版本必须等于或低于 X.X.X。当较新版本中存在已知不兼容的更改时使用。>=X.X.X:Bazel 版本必须等于或高于 X.X.X。当您依赖于一些从 X.X.X 版本开始才提供的功能时使用。-X.X.X:Bazel 版本 X.X.X 不兼容。当 X.X.X 中存在破坏您的 bug 时使用,但在后续版本中已修复。

multiple_version_override

None multiple_version_override(module_name, versions, registry='')

指定某个依赖项仍应来自注册表,但允许其多个版本共存。如需了解详情,请参阅相关文档。此指令仅在根模块中有效;换句话说,如果某个模块被其他模块用作依赖项,则其自己的替换项会被忽略。

参数

参数 说明
module_name string; 必需
要应用此替换项的 Bazel 模块依赖项的名称。
versions 字符串可迭代; 必需
明确指定允许共存的版本。这些版本必须已存在于依赖关系图预选择中。此模块的依赖项将“升级”如果依赖项的版本高于同一兼容性级别上允许的任何版本,则会导致错误。
registry string; 默认值为 ''
覆盖此模块的注册表;应使用指定的注册表,而不是从默认的注册表列表中查找此模块。

register_execution_platforms

None register_execution_platforms(dev_dependency=False, *platform_labels)

指定选择此模块时要注册的已定义的执行平台。应为绝对目标模式(即以 @// 开头)。如需了解详情,请参阅工具链解决方案。可扩展为多个目标的模式(例如 :all)将按名称的字典顺序注册。

参数

参数 说明
dev_dependency bool; 默认值为 False
如果为 true,如果当前模块不是根模块或已启用 `--ignore_dev_dependency`,系统不会注册执行平台。
platform_labels string 的序列; 必需
要注册的目标模式。

register_toolchains

None register_toolchains(dev_dependency=False, *toolchain_labels)

指定要在选择此模块时注册的已定义工具链。应为绝对目标模式(即以 @// 开头)。如需了解详情,请参阅工具链解决方案。扩展为多个目标的模式(例如 :all)将按目标名称(而不是工具链实现的名称)的字典顺序注册。

参数

参数 说明
dev_dependency bool; 默认值为 False
如果为 true,则当当前模块不是根模块或已启用“--ignore_dev_dependency”时,系统不会注册工具链。
toolchain_labels string 的序列; 必需
要注册的目标模式。

single_version_override

None single_version_override(module_name, version='', registry='', patches=[], patch_cmds=[], patch_strip=0)

指定依赖项仍应来自注册表,但应固定其版本、覆盖其注册表或应用的补丁列表。此指令仅在根模块中有效;换句话说,如果某个模块被其他模块用作依赖项,则其自己的替换项会被忽略。

参数

参数 说明
module_name string; 必需
要应用此替换项的 Bazel 模块依赖项的名称。
version string; 默认值为 ''
替换依赖关系图中此模块的声明版本。也就是说,此模块将被“固定”此替换版本。如果只覆盖注册表或补丁,则可以省略此属性。
registry string; 默认值为 ''
覆盖此模块的注册表;应使用指定的注册表,而不是从默认的注册表列表中查找此模块。
patches 字符串可迭代; 默认值为 []
指向要应用于此模块的补丁文件的标签列表。补丁文件必须存在于顶级项目的源代码树中。它们按列表顺序应用。
patch_cmds 字符串可迭代; 默认值为 []
应用补丁后,要应用于 Linux/Macos 的一系列 Bash 命令。
patch_strip int; 默认值为 0
与 Unix 补丁的 --strip 参数相同。

use_extension

module_extension_proxy use_extension(extension_bzl_file, extension_name, *, dev_dependency=False, isolate=False)

返回表示模块扩展的代理对象;可以调用其方法来创建模块扩展标记。

参数

参数 说明
extension_bzl_file string; 必需
Starlark 文件的标签,用于定义模块扩展名。
extension_name string; 必需
要使用的模块扩展的名称。Starlark 文件必须导出使用此名称的符号。
dev_dependency bool; 默认值为 False
如果为 true,如果当前模块不是根模块或已启用 `--ignore_dev_dependency`,系统会忽略这种模块扩展用法。
isolate bool; 默认值为 False
实验性。此参数处于实验阶段,随时可能发生变化。请勿依赖它。可以通过设置 --experimental_isolated_extension_usages
在实验性的基础上启用该功能。如果设置为 true,则模块扩展的这种用法将与此模块和其他模块中的所有其他用法隔离开来。针对此使用情况创建的标记不会影响其他使用情况,并且该扩展程序针对此使用情况生成的代码库将与该扩展程序生成的所有其他代码库不同。

此参数目前处于实验阶段,仅适用于标志 --experimental_isolated_extension_usages

use_repo

None use_repo(extension_proxy, *args, **kwargs)

将给定模块扩展程序生成的一个或多个代码库导入当前模块的作用域中。

参数

参数 说明
extension_proxy module_extension_proxy; 必需
use_extension 调用返回的模块扩展代理对象。
args 必需
要导入的代码库的名称。
kwargs 必需
以不同名称指定要导入到当前模块范围内的特定代码库。键应该是要在当前范围内使用的名称,而值应该是模块扩展程序导出的原始名称。

use_repo_rule

repo_rule_proxy use_repo_rule(repo_rule_bzl_file, repo_rule_name)

返回可在 MODULE.bazel 文件中作为代码库规则直接调用的代理值(一次或多次)。以这种方式创建的代码库只有当前模块使用代理上的 name 属性声明的名称下可见。隐式布尔值 dev_dependency 属性还可用于代理,以指明仅在当前模块为根模块时才创建特定代码库。

参数

参数 说明
repo_rule_bzl_file string; 必需
Starlark 文件的标签,用于定义代码库规则。
repo_rule_name string; 必需
要使用的代码库规则的名称。Starlark 文件必须导出使用此名称的符号。