一. 简介
前面一篇文章学习了 CMakeLists.txt语法中的 部分常量变量,具体学习提供信息的变量,文章如下:
CMakeLists.txt语法规则:提供信息的变量说明一-CSDN博客
CMakeLists.txt语法规则:提供信息的变量说明二-CSDN博客
CMakeLists.txt语法规则:改变行为的变量说明一-CSDN博客
本文继续学习 CMakeLists.txt语法中的常用变量,主要学习改变行为的一些常用变量。
二. CMakeLists.txt语法规则:改变行为的变量
1. CMAKE_INCLUDE_PATH 变量
为 find_file()命令 和 find_path() 命令指定搜索路径的目录列表。
这两个命令分别用于查找文件、路径,我们需要传入一个文件名,find_file() 命令会将该文件的全路径返回给我们;而 find_path() 命令则会将文件的所在目录返回给我们。
这 两 个 命 令 去 哪 儿去找 文 件 呢 ?
也 就 是 通 过 CMAKE_INCLUDE_PATH 变 量 来 进 行 指 定 ,CMAKE_INCLUDE_PATH 指定了一个目录列表,find_file()、find_path()会去这个目录列表中查找文件。
接下来我们进行测试。 譬如工程目录结构如下所示:
├── build
├── CMakeLists.txt
└── src
└── hello.c
顶层 CMakeLists.txt 文件内容如下:
# CMakeLists.txt
cmake_minimum_required("VERSION" "3.5")
project(HELLO VERSION 1.1.0) #设置工程版本号为 1.1.0
find_file(P_VAR hello.c)
message(${P_VAR})
通过 find_file 命令查找 hello.c 文件,将路径信息记录在 P_VAR 变量中;现在我们没有设置
CMAKE_INCLUDE_PATH 变量,看看能不能找到 hello.c 文件,进入build目录下,运行"cmake .." 命令,打印信息如下:
可以看到,很明显提示没有找到。
现在我们对 CMAKE_INCLUDE_PATH 变量进行设置, CMakeLists.txt 如下所示:
# CMakeLists.txt
cmake_minimum_required("VERSION" "3.5")
project(HELLO VERSION 1.1.0) #设置工程版本号为 1.1.0
# 设置 CMAKE_INCLUDE_PATH 变量
set(CMAKE_INCLUDE_PATH ${PROJECT_SOURCE_DIR}/src)
# 查找文件
find_file(P_VAR hello.c)
message(${P_VAR})
进入到 build 目录下,执行 cmake ..命令,此时打印信息为:
这次就成功找到了 hello.c 文件,并将文件的全路径返回给我们。