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() 调用后提交到仪表板服务器的结果。

OPTIONS <options>

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

RETURN_VALUE <result-var>

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

CAPTURE_CMAKE_ERROR <result-var>

版本 3.7 中添加。

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

QUIET

版本 3.3 中添加。

禁止向控制台打印任何本应在控制台中打印的非错误消息，而非错误消息指的是 CMake 特定的消息。基础配置命令的输出不受影响。