cmake：target_include_directories、include_directories、add_executable ╰半夏微凉° 2022-11-15 01:25 194阅读 0赞 # 引用路径 # 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目标器不能安装或导出。
还没有评论，来说两句吧...