option

提供一個布林選項,使用者可以選擇性地選取。

option(<variable> "<help_text>" [value])

如果沒有提供初始的 <value>,則布林值 OFF 為預設值。如果 <variable> 已經設定為一般變數或快取變數,則此命令不會執行任何動作 (請參閱政策 CMP0077)。

對於依賴其他選項值的選項,請參閱 CMakeDependentOption 模組的說明。

在 CMake 專案模式下,會使用選項值建立一個布林快取變數。在 CMake 腳本模式下,會使用選項值設定一個布林變數。