cmake：target_include_directories、include_directories、add_executable

引用路径

include_directories（）
target_include_directories（）
add_executable( xx.cpp     xx.h)

这三种方式都可以对当前项目添加引用路径。

include_directories

• include_directories（）的影响范围最大，可以为CMakelists.txt后的所有项目添加头文件目录
• 一般写在最外层CMakelists.txt中影响全局

target_include_directories

• target_include_directories（）的影响范围可以自定义。如加关键子PRIVATE或这PUBLIC。
• 一般引用库路径使用这个命令，作为外部依赖项引入进来，target是自己项目生成的lib。
  如:

project(myLib)
target_include_directories（myLib PRIVATE ${OpenCV_Include_dir}）

我们将${OpenCV_Include_dir}头文件库路径只添加到了myLib项目

add_executable

• add_executable( )中添加的引用路径一般是当前目录下的源文件对应的头文件。是生成项目时引入的头文件。

• 这种方式一般用于自己写的或某项目需要的头文件，这种方式需要加添加文件名字，而非头文件目录
  如：

project(addFunc)
add_executable（addFunc addFunc.h  addFunc.cpp）

官网翻译

include_directories

include_directories([AFTER|BEFORE] [SYSTEM] dir1 [dir2 ...])

将给定的目录添加到编译器用来搜索头文件的目录中。相对路径被解释为相对于当前源目录。

头目录被添加到当前CMakeLists文件的INCLUDE_DIRECTORIES目录属性中。它们还被添加到当前CMakeLists文件中每个目标的INCLUDE_DIRECTORIES目标属性中。目标属性值是生成器使用的属性值。

默认情况下，指定的目录会附加到当前目录列表中。这个默认行为可以通过设置cmake_include_directores_before为ON来改变。通过显式地使用AFTER或BEFORE，您可以在追加和前缀之间进行选择，而不依赖于默认值。

如果给出了SYSTEM选项，编译器将被告知在某些平台上，这些目录意味着系统包含目录。信号这个设置可能会达到一些效果，比如编译器跳过警告，或者这些固定安装的系统文件在依赖计算中不被考虑——参见编译器文档。

target_include_directories

target_include_directories(<target> [SYSTEM] [AFTER|BEFORE]
  <INTERFACE|PUBLIC|PRIVATE> [items1...]
  [<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])

指定编译给定目标时要使用的include目录。名为< target >的必须由add_executable()或add_library()等命令创建的，并且不能是ALIAS目标。

通过显式地使用AFTER或BEFORE，您可以在追加和前缀之间进行选择，而不依赖于默认值。

INTERFACE、PUBLIC和PRIVATE关键字用于（指定target_include_directories的影响范围）

add_executable

使用指定的源文件将可执行文件添加到项目中。

普通可执行文件

add_executable(<name> [WIN32] [MACOSX_BUNDLE]
               [EXCLUDE_FROM_ALL]
               [source1] [source2 ...])

添加一个名为< name >的可执行目标，以从命令调用中列出的源文件构建该目标。对应于逻辑目标名称，在项目中必须是全局唯一的。构建的可执行文件的实际文件名是基于本机平台的约定(例如< name >.exe或仅仅< name >)构造的。

3.1新版功能:add_executable的源参数可以使用语法为$<…>的"generator expressions"。关于可用的表达式，请参阅cmake-generator-expressions(7)手册。

3.11新版功能:如果稍后使用target_sources()添加源文件，则可以省略源文件。

默认情况下，将在构建树目录中创建可执行文件，该目录与调用该命令的源树目录对应。请参阅RUNTIME_OUTPUT_DIRECTORY目标属性的文档以更改此位置。请参阅OUTPUT_NAME目标属性的文档，以更改最终文件名的部分。

如果给定WIN32，将在创建的目标上设置属性WIN32_EXECUTABLE。有关详细信息，请参见该目标属性的文档。

如果给定MACOSX_BUNDLE，将在创建的目标上设置相应的属性。有关详细信息，请参阅MACOSX_BUNDLE目标属性的文档。

如果给出了EXCLUDE_FROM_ALL，将在创建的目标上设置相应的属性。详细信息请参见EXCLUDE_FROM_ALL目标属性的文档。

参见cmake-buildsystem(7)手册来定义更多的buildsystem属性。

请参见HEADER_FILE_ONLY，了解如果某些源是预处理过的，并且您希望在IDE中可以访问原始源，应该怎么做。

导入的可执行文件

add_executable(<name> IMPORTED [GLOBAL])

• 导入的可执行目标引用位于项目外部的可执行文件。
• 不会生成任何规则来构建它，并且导入的目标属性为True。
• 目标名称在创建它的目录及其下面具有作用域，但是GLOBAL选项扩展了可见性。它可以像项目中构建的任何目标一样被引用。
• 导入的可执行文件可以方便地从add_custom_command()等命令中引用。
• 关于导入可执行文件的详细信息是通过设置名称以IMPORTED_开头的属性来指定的。这类属性中最重要的是IMPORTED_LOCATION(以及它的每配置版本IMPORTED_LOCATION_)，它指定了主可执行文件在磁盘上的位置。有关更多信息，请参见IMPORTED_*属性的文档。

别名可执行文件

add_executable(<name> ALIAS <target>)

• 创建一个别名目标，以便可用于在后续命令中引用< Target >。在生成的构建系统中不会作为make目标出现。< target>不能是别名。
• 3.11新版功能:ALIAS可以以全局导入的目标为目标
• 3.18新版功能:ALIAS可以以非全局的导入目标为目标。这样的别名的作用域是创建它的目录和子目录。ALIAS_GLOBAL目标属性可用于检查别名是否为全局的。
• ALIAS目标可以用作从自定义命令和自定义目标读取属性的目标、可执行文件。还可以使用常规的if(TARGET)子命令来测试它们是否存在。不能用于修改的属性，也就是说，它不能用作set_property()、set_target_properties()、target_link_libraries()等的操作数。ALIAS目标器不能安装或导出。