ctest_build

作为 仪表板客户端 执行 CTest构建步骤。

ctest_build([BUILD <build-dir>] [APPEND]
            [CONFIGURATION <config>]
            [PARALLEL_LEVEL <parallel>]
            [FLAGS <flags>]
            [PROJECT_NAME <project-name>]
            [TARGET <target-name>]
            [NUMBER_ERRORS <num-err-var>]
            [NUMBER_WARNINGS <num-warn-var>]
            [RETURN_VALUE <result-var>]
            [CAPTURE_CMAKE_ERROR <result-var>]
            )

构建项目并将结果存储在 Build.xml 中，以便使用 ctest_submit() 命令提交。

CTEST_BUILD_COMMAND 变量可以设置为明确指定构建命令行。否则，将根据给定的选项自动计算构建命令行。

选项是：

构建<构建目录>

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

追加

标记 Build.xml 以追加到自上次 ctest_start 调用以来提交到仪表板服务器的结果。追加语义由正在使用的仪表板服务器定义。这 不会 导致将结果附加到先前调用此命令生成的 .xml 文件中。

配置<配置>

指定构建配置（例如``Debug``）。如果未指定，将检查“CTEST_BUILD_CONFIGURATION”变量。否则，将使用提供给 ctest(1) 命令的 -C <cfg> 选项（如果有的话）。

PARALLEL_LEVEL <平行>

在 3.21 版本加入.

指定底层构建系统的并行级别。如果未指定，将检查 CMAKE_BUILD_PARALLEL_LEVEL 环境变量。

FLAGS <标志>

将附加参数传递给基础构建命令。如果未指定，将检查“CTEST_BUILD_FLAGS”变量。例如，这可以用于使用 make 的 -j 选项触发并行构建。有关示例，请参见 ProcessorCount 模块。

PROJECT_NAME <项目名称>

自 CMake 3.0 以来被忽略。

在 3.14 版本发生变更: 不再需要此值。

TARGET <目标名称>

指定要构建的目标的名称。如果未指定，将检查“CTEST_BUILD_TARGET”变量。否则将构建默认目标。这是“所有”目标（在 Visual Studio Generators 中称为 ALL_BUILD）。

NUMBER_ERRORS <num-err-var>

存储在给定变量中检测到的构建错误数。

NUMBER_WARNINGS <num-warn-var>

存储在给定变量中检测到的构建警告数。

RETURN_VALUE <result-var>

将本机构建工具的返回值存储在给定变量中。

CAPTURE_CMAKE_ERROR <result-var>

在 3.7 版本加入.

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

安静

在 3.3 版本加入.

抑制任何本应打印到控制台的特定于 CTest 的非错误输出。警告/错误的摘要以及本机构建工具的输出不受此选项的影响。