build_command

取得建置當前專案的命令列。這主要用於 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>...]

其中 <cmake> 是 cmake(1) 命令列工具的位置，而 <config>、<parallel> 和 <target> 是提供給 CONFIGURATION、PARALLEL_LEVEL 和 TARGET 選項的值（如果有的話）。在 4.0 之前的 CMake 版本中，如果政策 CMP0061 未設定為 NEW，則為 Makefile Generators 新增了尾隨的 -- -i 選項。

當調用時，此 cmake --build 命令列將啟動底層的建置系統工具。

在版本 3.21 中新增：PARALLEL_LEVEL 參數可用於設定 --parallel 旗標。

build_command(<cachevariable> <makecommand>)

第二個簽名已被棄用，但仍可用於向後相容性。請改用第一個簽名。

它將給定的 <cachevariable> 設定為如上的命令列字串，但不包含 --target 選項。<makecommand> 會被忽略，但應該是 devenv、nmake、make 或其中一個最終使用者建置工具的完整路徑，以用於舊版調用。

注意

在 3.0 之前的 CMake 版本中，此命令返回一個直接調用當前產生器的原生建置工具的命令列。他們對 PROJECT_NAME 選項的實作沒有任何有用的效果，因此 CMake 現在會在使用該選項時發出警告。