ctest_configure

执行 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 特定的非错误消息。来自底层配置命令的输出不受影响。