ctest_start

开始测试给定模型

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

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

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

参数如下：

<模型>

设置仪表板模型。必须是“Experimental”、“Continuous”或“Nightly”之一。除非指定 APPEND ，否则此参数是必需的。

<来源>

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

<二进制>

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

组<组>

如果使用“GROUP”，提交将转到 CDash 服务器上的指定组。如果未指定“GROUP”，则默认使用模型名称。

在 3.16 版本发生变更: 这取代了弃用的选项 TRACK。尽管名称改变了，但它的行为没有改变。

追加

如果使用 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() 命令不同的模型或组，将发出警告，并使用新模型和组。

安静

在 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 变量），则其内容被视为命令行。调用命令时将当前工作目录设置为源目录的父目录，即使源目录已经存在。这可用于从版本控制存储库创建源代码树。