RESOURCE_GROUPS

3.16 版新增。

指定测试所需的资源，并以对测试有意义的方式进行分组。有关此属性如何集成到 CTest 资源分配功能中的更多信息，请参阅 资源分配。

RESOURCE_GROUPS 属性是分号分隔的列表。每个条目由可选的组描述后跟一系列这些组的资源需求组成。这些需求（以及组的数量）用逗号分隔。资源需求由资源类型的名称，后跟冒号，再后跟一个无符号整数组成，该整数指定给定类型的一个资源上所需的槽数。

RESOURCE_GROUPS 属性告诉 CTest 测试期望使用哪些资源，并以对测试有意义的方式进行分组。测试本身必须读取环境变量以确定已为每个组分配了哪些资源。例如，每个组可能对应于测试执行时将生成的进程。

考虑以下示例

add_test(NAME MyTest COMMAND MyExe)
set_property(TEST MyTest PROPERTY RESOURCE_GROUPS
  "2,gpus:2"
  "gpus:4,crypto_chips:2")

在此示例中，有两个组描述（隐式由分号分隔。）第一个描述的内容是 2,gpus:2。此描述指定了 2 个组，每个组需要单个 GPU 的 2 个槽。第二个描述的内容是 gpus:4,crypto_chips:2。此描述未指定组数，因此假定默认为 1。此单个组需要单个 GPU 的 4 个槽和单个加密芯片的 2 个槽。总共为此测试指定了 3 个资源组，每个组都有其自己的唯一需求。

请注意，资源类型后面的槽数指定的是*单个*资源实例的槽数。如果资源组可以容忍接收来自同一资源的不同实例的槽，它可以通过将规范拆分为多个单个槽的需求来指示。例如

add_test(NAME MyTest COMMAND MyExe)
set_property(TEST MyTest PROPERTY RESOURCE_GROUPS
  "gpus:1,gpus:1,gpus:1,gpus:1")

在这种情况下，单个资源组表示它需要四个 GPU 槽，所有这些槽都可以来自单独的 GPU（尽管它们不一定必须来自；CTest 仍然可以从同一个 GPU 分配槽）。

当 CTest 为测试设置环境变量时，它会根据组描述分配组号，从左侧的 0 开始，到右侧的组数减 1。例如，在上面的示例中，第一个描述中的两个组的 ID 将是 0 和 1，第二个描述中的单个组的 ID 将是 2。

RESOURCE_GROUPS 和 RESOURCE_LOCK 属性都具有相似的目的，但它们是不同的且正交的。由 RESOURCE_GROUPS 指定的资源不影响 RESOURCE_LOCK，反之亦然。而 RESOURCE_LOCK 是一个更简单的属性，用于锁定一个全局资源，RESOURCE_GROUPS 是一个更高级的属性，它允许多个测试同时使用相同类型的多个资源，并以细粒度的方式指定其需求。