option

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

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

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

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

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