一. 简介
前面几篇文章学习了 CMakeLists.txt语法中 部分常用命令。
接下来学习CMakeLists.txt语法中部分常用变量,变量也是 cmake 中的一个重头戏,cmake 提供了很多内置变量。每一个变量都有它自己的含义,可以通过如下链接地址查询到所有的内置变量及其相应的介绍:
https://cmake.org/cmake/help/v3.16/manual/cmake-variables.7.html
在这一份文档中,对变量进行分类。变量分为:提供信息的变量、改变行为的变量、描述系统的变量、控制编译的变量等等。
二. CMakeLists.txt语法规则:部分常用变量
1. 提供信息的变量
顾名思义,这种变量可以提供某种信息,既然如此,那么我们通常只需要读取变量即可,而不需要对变量进行修改:
|--------------------------|----------------------------------------------------------|
| ##### 变量 | ##### 说明 |
| PROJECT_SOURCE_DIR | 工程顶层目录,也就是顶层 CMakeLists.txt 源码所在目录 |
| PROJECT_BINARY_DIR | 工 程 BINARY_DIR , 也 就 是 顶 层 CMakeLists.txt 源码的 BINARY_DIR |
| CMAKE_SOURCE_DIR | 与 PROJECT_SOURCE_DIR 等价 |
| CMAKE_BINARY_DIR | 与 PROJECT_BINARY_DIR 等价 |
| CMAKE_CURRENT_SOURCE_DIR | 当前源码所在路径 |
| CMAKE_CURRENT_BINARY_DIR | 当前源码的 BINARY_DIR |
| CMAKE_MAJOR_VERSION | cmake 的主版本号 |
| CMAKE_MINOR_VERSION | cmake 的次版本号 |
| CMAKE_VERSION | cmake 的版本号(主+次+修订) |
| PROJECT_VERSION_MAJOR | 工程的主版本号 |
| PROJECT_VERSION_MINOR | 工程的次版本号 |
| PROJECT_VERSION | 工程的版本号 |
| CMAKE_PROJECT_NAME | 工程的名字 |
| PROJECT_NAME | 工程名,与 CMAKE_PROJECT_NAME 等价 |
2. PROJECT_SOURCE_DIR变量 和 PROJECT_BINARY_DIR 变量
PROJECT_SOURCE_DIR 变量表示工程的顶级目录,也就是顶层 CMakeLists.txt 文件所在目录;
PROJECT_BINARY_DIR 变 量 表示 工程 的 BINARY_DIR ,也 就是 顶 层 CMakeLists.txt 源 码 对 应的 BINARY_DIR (输出文件目录)。
譬如工程目录结构如下所示:
CMakeLists.txt 文件内容如下:
# CMakeLists.txt
cmake_minimum_required("VERSION" "3.16")
project(HELLO)
message(${PROJECT_SOURCE_DIR})
message(${PROJECT_BINARY_DIR})
CMakeLists.txt 中,我们打印了 PROJECT_SOURCE_DIR 和 PROJECT_BINARY_DIR 变量,进入到 build 目录下,执行 cmake :
从打印信息可知, PROJECT_SOURCE_DIR 指的就是工程的顶层 CMakeLists.txt 源码所在路径,而 PROJECT_BINARY_DIR 指的是我们执行 cmake 命令的所在目录。
3. CMAKE_SOURCE_DIR 和 CMAKE_BINARY_DIR
与上面两个等价,大家自己打印出来看看便知!
向 顶层 CMakeLists.txt 添加打印命令:
message(${CMAKE_SOURCE_DIR})
message(${CMAKE_BINARY_DIR})
进入 build目录下,执行 cmake ..命令后如下:
可以看出,与 PROJECT_SOURCE_DIR,PROJECT_BINARY_DIR一样的目录。