引用路径
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目标器不能安装或导出。