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