执行组

报告问题 查看来源 每晚 · 7.2。 · 7.1敬上 · 7.0。 · 6.5 · 6.4

执行组允许在单个目标中使用多个执行平台。 每个执行组都有自己的工具链依赖项, 会执行自己的工具链解析

背景

执行组允许规则作者定义一系列操作,其中每个操作都有 可能不同的执行平台。多个执行平台 以不同的方式执行某些操作,例如通过遥控器编译 iOS 应用 (linux) 工作器,然后使用本地 mac 工作器执行链接/代码签名。

能够定义操作组还有助于减少操作的使用 助记符作为指定操作的代理。系统不一定会 唯一且只能引用一项操作。这一功能在 将额外的资源分配给特定内存并处理密集型操作 例如在 C++ 构建中进行链接,而不会过度分配对要求不太严格的任务。

定义执行组

在定义规则的过程中,规则作者可以 声明 一组执行组。在每个执行组上,规则作者可以指定 为该执行组选择执行平台所需的所有信息, 即通过 exec_compatible_with 实现的所有约束,通过工具链类型实现的任何约束 toolchain

# foo.bzl
my_rule = rule(
    _impl,
    exec_groups = {
        “link”: exec_group(
            exec_compatible_with = [ "@platforms//os:linux" ]
            toolchains = ["//foo:toolchain_type"],
        ),
        “test”: exec_group(
            toolchains = ["//foo_tools:toolchain_type"],
        ),
    },
    attrs = {
        "_compiler": attr.label(cfg = config.exec("link"))
    },
)

在上面的代码段中,您可以看到工具依赖项还可以指定 使用 cfg 属性参数和 config 模块。该模块公开了一个接受单个字符串的 exec 函数 参数,这是应为其指定依赖项的执行组的名称 。

与原生规则一样,Starlark 上默认存在 test 执行组 测试规则。

访问执行组

在规则实施中,您可以声明应在 一个执行组的执行平台为此,您可以使用 exec_group 操作生成方法的参数,具体来说是 ctx.actions.runctx.actions.run_shell

# foo.bzl
def _impl(ctx):
  ctx.actions.run(
     inputs = [ctx.attr._some_tool, ctx.srcs[0]]
     exec_group = "compile",
     # ...
  )

规则作者还将能够访问已解决的工具链 执行组的功能,类似于 可以访问已解析的目标工具链:

# foo.bzl
def _impl(ctx):
  foo_info = ctx.exec_groups["link"].toolchains["//foo:toolchain_type"].fooinfo
  ctx.actions.run(
     inputs = [foo_info, ctx.srcs[0]]
     exec_group = "link",
     # ...
  )

使用执行组设置执行属性

执行组与 exec_properties 属性,可让目标写入者指定 然后传递给执行机器的属性字符串字典。对于 例如,如果要为目标设置某个属性(比如内存), 某些操作和更高的内存分配,您会编写一个 exec_properties 带有执行组扩展键的条目,例如:

# BUILD
my_rule(
    name = 'my_target',
    exec_properties = {
        'mem': '12g',
        'link.mem': '16g'
    }
    …
)

具有 exec_group = "link" 的所有操作都将看到执行属性 字典名称为{"mem": "16g"}。正如您在这里看到的,执行组级别 设置会覆盖目标级设置。

原生规则的执行组

以下执行组适用于原生规则定义的操作:

  • test:测试运行程序操作。
  • cpp_link:C++ 链接操作。

执行组和平台执行属性

可以在以下位置为任意执行组定义 exec_properties: 平台目标(与直接在目标上设置的 exec_properties 不同,其中 未知执行组的属性被拒)。然后,目标会继承 执行平台的 exec_properties(会影响默认执行组) 以及任何其他相关的执行组

例如,假设运行 C++ 测试需要一些可用的资源, 但编译和链接时不需要可以将其建模为 如下:

constraint_setting(name = "resource")
constraint_value(name = "has_resource", constraint_setting = ":resource")

platform(
    name = "platform_with_resource",
    constraint_values = [":has_resource"],
    exec_properties = {
        "test.resource": "...",
    },
)

cc_test(
    name = "my_test",
    srcs = ["my_test.cc"],
    exec_compatible_with = [":has_resource"],
)

直接针对目标定义的 exec_properties 的优先级高于 均从执行平台继承