ctest_start

针对给定模型开始测试

ctest_start(<model> [<source> [<binary>]] [GROUP <group>] [QUIET])

ctest_start([<model> [<source> [<binary>]]] [GROUP <group>] APPEND [QUIET])

针对给定模型开始测试。应在初始化二进制目录后调用该命令。

参数如下

<model>

设置仪表盘模型。必须为以下之一：Experimental、Continuous 或 Nightly。除非指定 APPEND，否则此参数为必需参数。

<source>

设置源目录。如果未指定，则使用 CTEST_SOURCE_DIRECTORY 的值。

<binary>

设置二进制目录。如果未指定，则使用 CTEST_BINARY_DIRECTORY 的值。

GROUP <group>

如果使用 GROUP，则提交内容将进入 CDash 服务器上的指定组。如果未指定 GROUP，则默认使用模型的名称。

3.16 版中已更改： 此命令替换了已弃用的选项 TRACK。尽管名称更改了，但其行为保持不变。

APPEND

如果使用 APPEND，则使用现有的 TAG，而不是根据当前时间戳创建新的 TAG。如果你使用 APPEND 则可以忽略 <model> 和 GROUP <group> 参数，因为它们会从生成的 TAG 文件中读取。例如

ctest_start(Experimental GROUP GroupExperimental)

稍后，在另一个 ctest -S 脚本中

ctest_start(APPEND)

当第二个脚本运行 ctest_start(APPEND) 时，它将从第一个 ctest_start() 命令生成的 TAG 文件中读取 Experimental 模型和 GroupExperimental 组。请注意，如果你调用 ctest_start(APPEND) 并指定不同于第一个 ctest_start() 命令的模型或组，则会发出警告，并且将使用新的模型和组。

QUIET

3.3 版中已添加。

如果使用 QUIET，则 CTest 将抑制任何非错误消息，这些消息原本会被打印到控制台。

参数 ctest_start() 可以按照任意顺序发出，但例外的是 <model>、<source> 和 <binary> 必须按照彼此之间的顺序出现。以下所有命令都是有效且等效的

ctest_start(Experimental path/to/source path/to/binary GROUP SomeGroup QUIET APPEND)

ctest_start(GROUP SomeGroup Experimental QUIET path/to/source APPEND path/to/binary)

ctest_start(APPEND QUIET Experimental path/to/source GROUP SomeGroup path/to/binary)

但是为了提高可读性，建议按照本页顶部列出的顺序对您的参数进行排序。

如果设置了 CTEST_CHECKOUT_COMMAND 变量（或 CTEST_CVS_CHECKOUT 变量），其内容将被视为命令行。此命令会在当前工作目录被设置为源目录的父级后调用，即使源目录已存在。这可用于从版本控制存储库中创建源树。