CMakeCache.txt
可以将其想象成一个配置文件(在Unix环境下,我们可以认为它等价于传递给configure的参数)。
- CMakeLists.txt 中通过 set(... CACHE ...) 设置的变量
- CMakeLists.txt 中的 option() 提供的选项
- CMakeLists.txt 中find_package() 等find命令引入变量
-
命令行 cmake . -D <var>:<type>=<value> 定义变量
cmake 第一次运行时将生成 CMakeCache.txt 文件,我们可以通过ccmake或cmake-gui或make edit_cache对其进行编辑。
对应于命令行 -D 定义变量,-U 用来删除变量(支持globbing_expr),比如 cmake -U/*QT/* 将删除所有名字中带有QT的cache项。
变量与Cache
cmake 的变量系统远比第一眼看上去复杂:
- 有些变量被cache,有些则不被cache
- 被cache的变量
- 有的不能通过ccmake等进行编辑(internal)
- 有的(带有描述和类型)可以被编辑(external)
- 有的只在ccmake的 advanced 模式出现
看个例子:
- SET(var1 13)
- 变量 var1 被设置成 13
- 如果 var1 在cache中已经存在,该命令不会overwrite cache中的值
- SET(var1 13 ... CACHE ...)
- 如果cache存在该变量,使用cache中变量
- 如果cache中不存在,将该值写入cache
- SET(var1 13 ... CACHE ... FORCE)
- 不论cache中是否存在,始终使用该值
要习惯用帮助
cmake --help-command SET
find_xxx
为了避免每次运行都要进行头文件和库文件的探测,以及考虑到允许用户通过ccmake设置头文件路径和库文件的重要性,这些东西必须进行cache。
- find_path 和 find_library 会自动cache他们的变量,如果变量已经存在且是一个有效值(即不是 -NOTFOUND 或 undefined),他们将什么都不做。
-
另一方面,模块查找时输出的变量(<name>_FOUND,<name>_INCLUDE_DIRS,<name>_LIBRARIES)不应该被cache