include_directories
将指定目录添加到编译器的头文件搜索路径之下,指定的目录被解释成当前源码路径的相对路径。
语法格式:
include_directories ([AFTER|BEFORE] [SYSTEM] dir1 [dir2 ...])
默认情况下,include_directories命令会将目录添加到列表最后(AFTER选项)。不过,可以通过命令设置CMAKE_INCLUDE_DIRECTORIES_BEFORE 变量为ON来改变它的默认行为,将目录添加到列表前面。也可以在每次调用include_directories命令时使用AFTER或BEFORE选项来指定是添加到列表的前面或者后面。如果使用SYSTEM选项,会把指定目录当成系统的搜索目录。该命令作用范围只在当前的CMakeLists.txt。
例如,在Linux下,C编译器默认搜索路径:
/usr/include
/usr/local/include
如果我们项目根目录下,有个公共头文件目录include1、include2需要添加到C编译器的默认搜索路径,可以在CMakeLists.txt中添加:
include_directories(include1) # 注意当前CMakeLists.txt和include1相对路径关系, 此时必须是在同一个目录下
include_directories(${PROJECT_SOURCE_DIR}/include2) # 通过源码根目录来定位include2
target_include_directories
为指定目标(target)添加搜索路径,指定目标是指通过如add_executable(),add_library()这样的命令生成的,并且决不能是alias target(引用目标,别名目标)。
语法格式:
target_include_directories(<target> [SYSTEM] [AFTER|BEFORE] <INTERFACE|PUBLIC|PRIVATE> [items1...] [<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])
AFTER或BEFORE
可以选择让添加的路径位于搜索列表的开头或结尾。缺省时,默认是AFTER。
INTERFACE,PUBLIC,PRIVATE
指定接下来的参数item(即路径)的作用域:
- INTERFACE target对应的头文件才能使用,会指定target的属性INTERFACE_INCLUDE_DIRECTORIES
- PUBLIC target对应头文件和源文件都能使用,会指定target的属性INCLUDE_DIRECTORIES 和INTERFACE_INCLUDE_DIRECTORIES
- PRIVATE target对应源文件使用,会指定target的属性INCLUDE_DIRECTORIES
注意:
1)所谓使用是指添加头文件搜索路径(item)。
2)target的属性可以通过set_property()修改。
例如,单独为目标projectA添加搜索路径include1。
target_include_directories(projectA ./include1) # 注意当前CMakeLists.txt与include1路径的相对位置关系
add_executable(projectA main.cpp)
SYSTEM
如果指定SYSTEM,在一些平台上,编译器会将路径作系统包含目录路径,可能对包含的头文件在依赖计算时的警告或者忽略,有一些影响。如果SYSTEM和PUBLIC或INTERFACE同时指定,target的属性INTERFACE_SYSTEM_INCLUDE_DIRECTORIES将填充指定目录。
include_directories与target_include_directories区别
include_directories 会为当前CMakeLists.txt的所有目标,以及之后添加的所有子目录的目标添加头文件搜索路径。因此,慎用target_include_directories,因为会影响全局target。
target_include_directories 只会为指定目标包含头文件搜索路径。如果想为不同目标设置不同的搜索路径,那么用target_include_directories更合适。
参考
https://cmake.org/cmake/help/latest/command/target_include_directories.html