CMakeLists.txt语法规则：改变行为的变量说明二

一.  简介

前面一篇文章学习了 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 变量指定的目录列表中搜索。