包含目录¶
将包含目录添加到构建中。
include_directories([AFTER|BEFORE] [SYSTEM] dir1 [dir2 ...])
将给定目录添加到编译器用于搜索包含文件的目录。相对路径被解释为相对于当前源目录。
包含目录被添加到当前 CMakeLists 文件的 INCLUDE_DIRECTORIES 目录属性中。它们也被添加到当前 CMakeLists 文件中每个目标的 INCLUDE_DIRECTORIES 目标属性中。目标属性值是生成器使用的值。
默认情况下,指定的目录附加到当前目录列表中。可以通过将 CMAKE_INCLUDE_DIRECTORIES_BEFORE 设置为 ON 来更改此默认行为。通过显式使用 AFTER 或 BEFORE,您可以独立于默认值在追加和前置之间进行选择。
如果给出了“SYSTEM”选项,编译器将被告知这些目录在某些平台上是系统包含目录。发出此设置信号可能会达到编译器跳过警告等效果,或者这些固定安装的系统文件在依赖项计算中不被考虑 - 请参阅编译器文档。
include_directories 的参数可以使用语法为“$<...>”的生成器表达式。请参阅 cmake-generator-expressions(7) 手册了解可用的表达式。 |更多_另见|
备注
首选 target_include_directories() 命令将包含目录添加到各个目标,并可选择将它们传播/导出到依赖项。