ctest_configure

以Dashboard Client身份执行CTest 配置步骤。

ctest_configure([BUILD <build-dir>] [SOURCE <source-dir>] [APPEND]
                [OPTIONS <options>] [RETURN_VALUE <result-var>] [QUIET]
                [CAPTURE_CMAKE_ERROR <result-var>])

配置项目构建树并将结果记录在Configure.xml中，以便使用ctest_submit()命令提交。

选项包括

BUILD <build-dir>

指定顶层构建目录。如果未给出，则使用CTEST_BINARY_DIRECTORY变量。

SOURCE <source-dir>

指定源目录。如果未给出，则使用CTEST_SOURCE_DIRECTORY变量。

APPEND

标记Configure.xml，以便在上次ctest_start()调用后，将结果附加到先前已提交到仪表板服务器的结果中。附加语义由所使用的仪表板服务器定义。这不会导致结果附加到由先前对此命令的调用生成的.xml文件。

OPTIONS <options>

指定要传递给配置工具的命令行参数。

RETURN_VALUE <result-var>

将本机配置工具的返回值存储在<result-var>变量中。

CAPTURE_CMAKE_ERROR <result-var>

3.7 版本中新增。

如果运行命令时有任何错误，则在 <result-var> 变量中存储 -1，并防止 ctest 在发生错误时返回非零值。

QUIET

3.3 版本中新增。

抑制任何原本会打印到控制台的 CTest 特定的非错误消息。底层配置命令的输出不受影响。