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
变量,其内容将被视为命令行。即使源目录已存在,也会在当前工作目录设置为源目录的父目录的情况下调用该命令。这可用于从版本控制存储库创建源树。