一. 简介
前面一篇文章学习了 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 文件,并将文件的全路径返回给我们。
2. CMAKE_LIBRARY_PATH 变量
指定 find_library() 命令的搜索路径的目录列表。
find_library() 命令用于搜索库文件, find_library() 将会从CMAKE_LIBRARY_PATH 变量设置的目录列表中进行搜索。
3. CMAKE_MODULE_PATH 变量
指定要由 include() 或 find_package() 命令加载的 CMake 模块的搜索路径的目录列表。
4. CMAKE_INCLUDE_DIRECTORIES_BEFORE 变量
这个变量可以改变 include_directories() 命令的行为。
include_directories() 命令默认情况下会将目录添加到列表的后面,如果将 CMAKE_INCLUDE_DIRECTORIES_BEFORE 设置为 on ,则 include_directories() 命令会将目录添加到列表前面;
同理若将 CMAKE_INCLUDE_DIRECTORIES_BEFORE 设置为 off 或未设置该变量, include_directories() 会将目录添加到列表后面。
5. CMAKE_IGNORE_PATH 变量
要被 find_program()、find_library()、find_file() 和 find_path() 命令忽略的目录列表。 表示这些命令不会去 CMAKE_IGNORE_PATH 变量指定的目录列表中搜索。