CMakeLists.txt语法规则:部分常用命令说明四

2024-05-06 08:20

本文主要是介绍CMakeLists.txt语法规则:部分常用命令说明四,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

一.  简介

前面几篇文章学习了CMakeLists.txt语法中前面几篇文章学习了CMakeLists.txt语法中部分常用命令。文章如下:

CMakeLists.txt语法规则:部分常用命令说明一-CSDN博客

CMakeLists.txt语法规则:部分常用命令说明二-CSDN博客

CMakeLists.txt语法规则:部分常用命令说明三-CSDN博客

本文继续学习 CMakeLists.txt语法中两个常用命令:target_include_directories命令 和 target_link_libraries命令。

二.  CMakeLists.txt语法规则:部分常用命令

target_include_directories命令 和 target_link_libraries命令

target_include_directories 命令为指定目标设置头文件搜索路径。
target_link_libraries 命令为指定目标设置链接库文件。
这听起来跟 include_directories link_libraries 命令有着相同的作用,确实如此,它们的 功能的确相同,但是在一些细节方面却有不同。
target_include_directories target_link_libraries 命令定义如下所示:
target_include_directories(<target> [SYSTEM] [BEFORE]<INTERFACE|PUBLIC|PRIVATE> [items1...][<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])target_link_libraries(<target><PRIVATE|PUBLIC|INTERFACE> <item>...[<PRIVATE|PUBLIC|INTERFACE> <item>...]...)

这俩命令都有一个相同的参数 <target> 目标,这个目标指的就是譬如 add_executable add_library 命令所创建的目标。
首 先 对 于 target_include_directories 命 令 来 说 , SYSTEM BEFORE 这 两 个 选 项 与
include_directories 命令中 SYSTEM BEFORE 选项的意义相同。
如果使用 SYSTEM 选项,会把指定目录当成系统的搜索目录。 通过  BEFORE 选项可显式指定添加到列表的前面。

我们重点关注的是 INTERFACE|PUBLIC|PRIVATE 这三个选项有何不同?
通过一个示例向大家说明,譬如工程目录结构如下所示:

调用关系:

根据以上工程,我们对 INTERFACE PUBLIC PRIVATE 三个关键字进行说明:
PRIVATE 私有的。
main.c 程序调用了 libhello_world.so 。生成 libhello_world.so 时,只在 hello_world.c 中包含了 hello.h libhello_world.so 对外的头文件: hello_world.h 头文件中不包含 hello.h
而且 main.c 不会调用 hello.c 中的函数,或者说 main.c 不知道 hello.c 的存在,它只知道 libhello_world.so 的存在;
那么在 hello_world/CMakeLists.txt 中应该写入:
target_link_libraries(hello_world PRIVATE hello)
target_include_directories(hello_world PRIVATE hello)

INTERFACE 接口。
生成 libhello_world.so 时,只在 libhello_world.so 对外的头文件: hello_world.h 文件 中包含了 hello.h hello_world.c 中不包含 hello.h ,即 libhello_world.so 不使用 libhello.so 提供的功能,但是 main.c 需要使用 libhello.so 中的功能。
那么在 hello_world/CMakeLists.txt 中应该写入:
target_link_libraries(hello-world INTERFACE hello)
target_include_directories(hello-world INTERFACE hello)

PUBLIC 公开的。
PUBLIC = PRIVATE + INTERFACE 。生成 libhello_world.so 时,在 hello_world.c 和 hello_world.h 中 都 包 含 了 hello.h 。 并 且 main.c 中 也 需 要 使 用 libhello.so 提 供 的 功 能 。
那 么 在 hello_world/CMakeLists.txt 中应该写入:
target_link_libraries(hello-world PUBLIC hello)
target_include_directories(hello-world PUBLIC hello)

对于 target_include_directories命令 来说,这些关键字用于指示 何时 需要传递给目标的 包含目录列表 ,指定了 包含目录列表 的使用范围( scope ):
当使用 PRIVATE 关键字修饰时,意味着 包含目录列表 仅用于当前目标;
当使用 INTERFACE 关键字修饰时,意味着 包含目录列表 不用于当前目标、只能用于依赖该目标的其它目标,也就是说 cmake 会将 包含目录列表 传递给当前目标的依赖目标;
当使用 PUBLIC 关键字修饰时,这就是以上两个的集合, 包含目录列表 既用于当前目标、也会传递给当前目标的依赖目标。

对于 target_link_libraries命令 亦是如此,只不过 包含目录列表 换成了 链接库列表 譬如:
target_link_libraries(hello_world INTERFACE hello)
表示目标 hello_world 不需要链接 hello 库,但是对 hello_world 目标的依赖目标(依赖于 hello_world 的目标)它们需要链接 hello 库。
以上便是对 INTERFACEPUBLICPRIVATE 这三个关键字的概括性理解,所以整出这几个关键 字主要还是为了控制包含目录列表链接库列表的使用范围,这就是 target_include_directories
target_link_libraries 命令与 include_directorieslink_libraries 命令的不同之处。
target_include_directories() 功能与 target_link_libraries()的功能完全可以使用 include_directories()link_libraries()来实现。
但是笔者强烈建议大家使用 target_include_directories()和 target_link_libraries()。为什么?保持清晰!
include_directories() link_libraries() 是针对当前源码中的所有目标,并且还会向下传递(譬如通过 add_subdirectory 加载子源码时,也会将其传递给子源码)。
在一个大的工程当中,这通常不规范、有时还 会编译出现错误、混乱,所以我们应尽量使用 target_include_directories() target_link_libraries() ,保持整个 工程的目录清晰。

下一篇文章继续学习 CMakeLists.txt语法的一个常用命令: message命令。

这篇关于CMakeLists.txt语法规则:部分常用命令说明四的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!


原文地址:
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.chinasem.cn/article/963868

相关文章

Spring中管理bean对象的方式(专业级说明)

《Spring中管理bean对象的方式(专业级说明)》在Spring框架中,Bean的管理是核心功能,主要通过IoC(控制反转)容器实现,下面给大家介绍Spring中管理bean对象的方式,感兴趣的朋... 目录1.Bean的声明与注册1.1 基于XML配置1.2 基于注解(主流方式)1.3 基于Java

Nginx路由匹配规则及优先级详解

《Nginx路由匹配规则及优先级详解》Nginx作为一个高性能的Web服务器和反向代理服务器,广泛用于负载均衡、请求转发等场景,在配置Nginx时,路由匹配规则是非常重要的概念,本文将详细介绍Ngin... 目录引言一、 Nginx的路由匹配规则概述二、 Nginx的路由匹配规则类型2.1 精确匹配(=)2

mysql递归查询语法WITH RECURSIVE的使用

《mysql递归查询语法WITHRECURSIVE的使用》本文主要介绍了mysql递归查询语法WITHRECURSIVE的使用,WITHRECURSIVE用于执行递归查询,特别适合处理层级结构或递归... 目录基本语法结构:关键部分解析:递归查询的工作流程:示例:员工与经理的层级关系解释:示例:树形结构的数

Java使用Stream流的Lambda语法进行List转Map的操作方式

《Java使用Stream流的Lambda语法进行List转Map的操作方式》:本文主要介绍Java使用Stream流的Lambda语法进行List转Map的操作方式,具有很好的参考价值,希望对大... 目录背景Stream流的Lambda语法应用实例1、定义要操作的UserDto2、ListChina编程转成M

idea报错java: 非法字符: ‘\ufeff‘的解决步骤以及说明

《idea报错java:非法字符:‘ufeff‘的解决步骤以及说明》:本文主要介绍idea报错java:非法字符:ufeff的解决步骤以及说明,文章详细解释了为什么在Java中会出现uf... 目录BOM是什么?1. BOM的作用2. 为什么会出现 \ufeff 错误?3. 如何解决 \ufeff 问题?最

Python正则表达式语法及re模块中的常用函数详解

《Python正则表达式语法及re模块中的常用函数详解》这篇文章主要给大家介绍了关于Python正则表达式语法及re模块中常用函数的相关资料,正则表达式是一种强大的字符串处理工具,可以用于匹配、切分、... 目录概念、作用和步骤语法re模块中的常用函数总结 概念、作用和步骤概念: 本身也是一个字符串,其中

Nginx location匹配模式与规则详解

《Nginxlocation匹配模式与规则详解》:本文主要介绍Nginxlocation匹配模式与规则,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、环境二、匹配模式1. 精准模式2. 前缀模式(不继续匹配正则)3. 前缀模式(继续匹配正则)4. 正则模式(大

Mysql用户授权(GRANT)语法及示例解读

《Mysql用户授权(GRANT)语法及示例解读》:本文主要介绍Mysql用户授权(GRANT)语法及示例,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录mysql用户授权(GRANT)语法授予用户权限语法GRANT语句中的<权限类型>的使用WITH GRANT

HTML5表格语法格式详解

《HTML5表格语法格式详解》在HTML语法中,表格主要通过table、tr和td3个标签构成,本文通过实例代码讲解HTML5表格语法格式,感兴趣的朋友一起看看吧... 目录一、表格1.表格语法格式2.表格属性 3.例子二、不规则表格1.跨行2.跨列3.例子一、表格在html语法中,表格主要通过< tab

Java使用ANTLR4对Lua脚本语法校验详解

《Java使用ANTLR4对Lua脚本语法校验详解》ANTLR是一个强大的解析器生成器,用于读取、处理、执行或翻译结构化文本或二进制文件,下面就跟随小编一起看看Java如何使用ANTLR4对Lua脚本... 目录什么是ANTLR?第一个例子ANTLR4 的工作流程Lua脚本语法校验准备一个Lua Gramm