FIXTURES_CLEANUP

3.7 版本中新增。

指定一个测试需要清理的 fixture 列表。这些 fixture 名称与测试用例名称不同，并且不需要与其关联的测试名称有任何相似之处。

Fixture 清理测试是普通的测试，具有所有常规的测试功能。为测试设置 FIXTURES_CLEANUP 属性主要有两个效果：

• CTest 将确保该测试在所有列出了其 FIXTURES_REQUIRED 属性中的任何 fixture 的其他所有测试之后执行。

• 如果 CTest 被要求只运行一部分测试（例如，使用正则表达式或 --rerun-failed 选项），并且清理测试不在要运行的测试集中，那么如果该集中的任何测试需要 FIXTURES_CLEANUP 中列出的任何 fixture，它将自动被添加。

一个清理测试可以在其 FIXTURES_CLEANUP 属性中列出多个 fixture。它将只为整个 CTest 运行执行一次，而不是为每个 fixture 执行一次。一个 fixture 也可以定义多个清理测试。如果一个 fixture 有多个清理测试，项目可以根据需要使用普通的 DEPENDS 测试属性来控制它们的顺序。

清理测试允许要求其他 fixture，但不能要求在其 FIXTURES_CLEANUP 属性中列出的任何 fixture。例如：

# Ok: Dependent fixture is different to cleanup
set_tests_properties(cleanupFoo PROPERTIES
  FIXTURES_CLEANUP  Foo
  FIXTURES_REQUIRED Bar
)

# Error: cannot require same fixture as cleanup
set_tests_properties(cleanupFoo PROPERTIES
  FIXTURES_CLEANUP  Foo
  FIXTURES_REQUIRED Foo
)

即使该 fixture 的设置或常规测试失败或被跳过，清理测试也会执行。

有关如何使用测试 fixture 的更完整讨论，请参阅 FIXTURES_REQUIRED。