option

提供一个布尔选项,用户可以选择性地选中。

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

如果没有提供初始 <value>,则默认值为布尔值 OFF。如果 <variable> 已经设置为普通变量或缓存变量,则该命令不起作用(参见策略 CMP0077)。

在 CMake 项目模式下,会创建一个布尔缓存变量,其值为选项的值。在 CMake 脚本模式下,会设置一个布尔变量,其值为选项的值。

另请参阅

  • 推荐使用 CMakeDependentOption 模块来指定依赖于其他选项值或一组条件的布尔选项。