option

提供一个用户可以选择的布尔选项。

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

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

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

另请参阅

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