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>...] [-- -i]

其中 <cmake> 是 cmake(1) 命令列工具的位置，而 <config>、<parallel> 和 <target> 是提供給 CONFIGURATION、PARALLEL_LEVEL 和 TARGET 選項的值（如果有的話）。如果政策 CMP0061 未設定為 NEW，則會為 Makefile 產生器 加入尾隨的 -- -i 選項。

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

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

build_command(<cachevariable> <makecommand>)

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

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

注意

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