option

提供一项布尔选项,用户可以根据需要选择。

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

如果没有提供初始 <value>,布尔值 OFF 是默认值。如果 <variable> 已被设置为普通变量或缓存变量,则此命令不执行任何操作(请参见策略 CMP0077)。

对于取决于其他选项值的选项,请参见用于 CMakeDependentOption 的模块帮助。

在 CMake 项目模式下,将根据选项值创建一个布尔缓存变量。在 CMake 脚本模式下,将根据选项值设置一个布尔变量。