构建命令

获取命令行以构建当前项目。这主要供 CTest 模块内部使用。

build_command(<variable>
              [CONFIGURATION <config>]
              [PARALLEL_LEVEL <parallel>]
              [TARGET <target>]
              [PROJECT_NAME <projname>] # legacy, causes warning
             )

将给定的 <variable> 设置为以下形式的命令行字符串：

<cmake> --build . [--config <config>] [--parallel <parallel>] [--target <target>...] [-- -i]

其中 <cmake> 是 cmake(1) 命令行工具的位置，<config>、<parallel> 和 <target>` ` 是提供给 ``CONFIGURATION、PARALLEL_LEVEL 和 TARGET 选项的值（如果有的话）。如果策略:policy:CMP0061 未设置为 NEW，则为 Makefile Generators 添加尾随的 -- -i 选项。

调用时，此 cmake --build 命令行将启动底层构建系统工具。

在 3.21 版本加入: PARALLEL_LEVEL 参数可用于设置:option:--parallel <cmake--build --parallel> 标志。

build_command(<cachevariable> <makecommand>)

第二个签名已弃用，但仍可用于向后兼容。请改用第一个签名。

它将给定的 <cachevariable> 设置为上面的命令行字符串，但没有 --target 选项。 <makecommand> 被忽略但应该是 devenv、nmake、make 或用于遗留调用的最终用户构建工具之一的完整路径。

备注

在 3.0 之前的 CMake 版本中，此命令返回一个命令行，该命令行直接调用当前生成器的本机构建工具。他们对 PROJECT_NAME 选项的实现没有任何有用的效果，因此 CMake 现在会在使用该选项时发出警告。