【cmake学习】cmake 引入第三方库(头文件目录、库目录、库文件)

2023-05-16

程序的编写需要用到头文件,程序的编译需要lib文件,程序的运行需要dll文件,因此cmake引入第三方库其实就是将include目录、lib目录、bin目录引入工程。


        目录

1、find_package(批量引入库文件和头文件)

2、include_directories(引入头文件目录)

3、link_directories(引入库文件目录到当前工程)

4、link_libraries (引入库文件到当前工程)

5、target_link_libraries(引入库文件到子工程)

6、target_include_directories(引入头文件目录到子工程)


1、find_package(批量引入库文件和头文件)

find_package 的详细使用:find_package 的详细使用

find_package 需要通过 .cmake 为后缀的文件引入,能够将 .cmake 包含的库和头文件全部引入工程。不同的库的达到的效果不同。有时需要搭配关键字使用:

  • REQUIRED:必须找到该库,找不到就报错
  • COMPONENTS:从库中找子库(模块)xx,比如COMPONENTS Widget表示找到子模块Widget

以OpenCV库为例,OpenCV库提供的是 OpenCVConfig.cmake文件,只需引入一次,便可以将OpenCV所有的库文件和头文件引入到当前工程。OpenCVConfig.cmake 也给出了详细的说明。

find_package(OpenCV REQUIRED)

# OpenCV_INCLUDE_DIRS 是预定义变量,代表OpenCV库的头文件路径
include_directories(${OpenCV_INCLUDE_DIRS}) 

# OpenCV_LIBS 是预定义变量,代表OpenCV库的lib库文件
target_link_libraries(MY_TARGET_NAME ${OpenCV_LIBS})

以QT库为例,QT库是一个大型库,内部还包含了许多子库,在引入的时候最好按需引入

# 含义:必须找到Qt5库的子模块Core,找不到就报错
find_package(Qt5 COMPONENTS Core REQUIRED)

# 链接时需要加上前缀Qt::(这里是Qt5的库)
target_link_libraries(qt_test
    Qt5::Core
)

注意:无论是上面的Widget,还是Core,都是去掉了前缀Qt5。实际上,Qt的子库名字都是有前缀 "Qt5" 的!只不过在引入的时候,要去掉。

2、include_directories(引入头文件目录

include_directories表示引入头文件搜索路径,当工程要用到某个头文件的时候,就会去该路径下搜索。一般都是在顶层的CmakeList文件中添加搜索路径。

include_directories(完整路径)
# 绝对路径引入
include_directories("D:\\ProgramFiles\\Qt\\qt5_7_lib_shared_64\\include")

# 普通变量引入(可以理解为把D:\\ProgramFiles\\Qt\\qt5_7_lib_shared_64放入一个集合INCLUDE_PATH)
# ${变量名} 可以获取集合内容,允许拼接
set (INCLUDE_PATH D:\\ProgramFiles\\Qt\\qt5_7_lib_shared_64)
include_directories(${INCLUDE_PATH}/include)       

# 环境变量引入
# 假设环境变量是INCLUDE_PATH = D:\\ProgramFiles\\Qt\\qt5_7_lib_shared_64
# #ENV{环境变量名} 可以获取环境变量的内容,允许拼接
include_directories($ENV{INCLUDE_PATH}/include)

一个cmake总工程可以包含多个子工程,总工程引入的头文件,并不代表子工程就可以用,就好比幼儿园老师(总工程)买来一箱苹果,小朋友(子工程)根据需求拿苹果。

3、link_directories(引入库目录——添加库文件的搜索路径)

link_libraries 表示添加第三方 lib 库文件的搜索路径。若工程在编译的时候会需要用到某个第三方库的 lib 文件,此时就可以使用 link_libraries 来添加搜索路径。

link_libraries(完整路径)
# 绝对引入
link_libraries("D:\ProgramFiles\Qt\qt5_7_lib_shared_64\lib")

# 预定义变量引入
# PROJECT_SOURCE_DIR 是cmake的预定义变量,表示顶层CmakeList文件所在路径
link_libraries(${PROJECT_SOURCE_DIR}/ExtLib/ffmpeg/win64/lib)

# 环境变量引入
# 环境变量 QT_LIB = D:\\ProgramFiles\\Qt\\qt5_7_lib_shared_64
link_libraries($ENV{QT_LIB}/lib)

4、link_libraries (引入库文件)

link_libraries 表示将具体的库文件引入到当前工程中,所填入的路径必须是全路径。

# 全路径引入
LINK_LIBRARIES("/opt/MATLAB/R2012a/bin/glnxa64/libeng.so")

5、target_link_libraries(引入库文件到子工程)

target_link_libraries 表示添加第三方 lib 库文件到目标子工程,上面 link_directories 是引入库目录到当前工程,link_libraries 是引入库文件到当前工程,具体是哪个工程并没有指明。就好比,货车把满载的货物运到幼儿园里,但是没分配。

target_link_libraries 起的作用就是分发工作,分发xx库给指定工程,注意xx库必须是当前工程中有的或者 搜索路径里有的。

target_link_libraries(子工程名 库文件1 库文件2 ...)     # 注意子工程名和库文件名之间以空格隔开
add_executable(qt_test ${ALL_SRCS})    # 子工程名是 qt_test 

# 绝对路径引入
target_link_libraries(qt_test 
    D:\\ProgramFiles\\Qt\\qt5_7_lib_shared_64\\lib\\Qt5Core.lib
    D:\\ProgramFiles\\Qt\\qt5_7_lib_shared_64\\lib\\Qt5Gui.lib
)

# 普通变量引入(被打包的lib文件,必须能在搜索路径下找到)
set (LIB_FFMPEG "avcodec.lib" "avdevice.lib" "avfilter.lib")
target_link_libraries(qt_test 
    ${LIB_FFMPEG}
)

# 预定义变量引入
# PROJECT_SOURCE_DIR 是cmake的预定义变量,表示顶层CmakeList文件所在路径
target_link_libraries(qt_test 
    ${PROJECT_SOURCE_DIR}/ExtLib/ffmpeg/win64/lib/avcodec.lib
)

6、target_include_directories(引入头文件目录到子工程)

target_include_directories 达到的效果和 target_link_libraries 是类似的,需要注意的是

  • include_directories:将头文件目录引入到当前工程
  • target_include_directories:将头文件目录针对性的引入到目标子工程(当前工程一般可以包含多个子工程) 
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)

【cmake学习】cmake 引入第三方库(头文件目录、库目录、库文件) 的相关文章

随机推荐

  • STM32 HAL库的中断(一)外部中断&&UART中断

    STM32 HAL库的中断 可以说大型任务里面逃不掉中断的使用 xff0c 在从标准库开发转向HAL库开发的过程中 xff0c HAL库函数层层调用的函数关系着实令人头皮发麻 xff0c 在此记录一下自己一下午的摸索 xff0c 本文将持续
  • Jetson Nano使用Tensorrt加速Yolo V4-tiny进行实时检测

    之前在Darknet下使用Yolo V4 tiny进行了图像实时检测的测试 xff0c 发现帧率一直只有十几 xff0c 还有很大的提升空间 xff0c 今天就来尝试一下使用tensorrt进行加速后的效果 基础环境 Jetson Nano
  • gazebo如何加载sdf文件的模型

    目录 大致过程sdf文件包含在world文件设置sdf文件的路径1 把文件直接放到能被gazebo找得到的目录下2 设置环境变量使gazebo能找到该文件3 在package xml文件添加路径 参考文献留有疑问 大致过程 gazebo只能
  • 串口应用:发送数据

    功能描述 xff1a 1 每隔3ms以115200波特率的速度发送一个遵循uart协议的数据 每次发送数据增大1 xff08 从0开始即可 xff09 2 数据 来自数据采集器 xff0c 每采集一个数据 xff0c 发送一个脉冲告知串口
  • github更新子模块指令

    span class token function git span submodule update init recursive 更新子模块
  • ..\OBJ\LED.axf: Error: L6218E: Undefined symbol xTaskGetSchedulerState (referred from delay.o).

    文章目录 前言解决办法 前言 在学习FreeRTOS移植后 xff0c 编译出现 OBJ LED axf Error L6218E Undefined symbol xTaskGetSchedulerState referred from
  • STM32中HAL库与标准库的区别

    这是扒的某网站上大佬们的见解 1 HAL库就是封装的比较猛 xff0c 移植性比较强 xff0c 标准库就是将寄存器封装好 xff0c 移植性没有HAL好 2 HAL库可以用ST的软件CUBE生成初始化工程 3 HAL库最方便的就是可以用C
  • 在vsCode中如何使用git工具来管理代码

    git add git status 显示文件的状态 git commit m 我是内容 需要工具 xff1a VSCode 在VSCode官网上下载VSCode并进行安装 VSCode官方网站 https code visualstudi
  • TCP 可靠性的关键机制 —— 确认应答机制 (ACK)

    确认应答机制是 实现TCP可靠性的关键机制 xff0c 简单来说 xff0c 确认应答机制就是 xff0c 客户端和服务端任意一方 xff0c 在发送消息之后 xff0c 都必须要收到对方的回复来表明自己发送的消息已经被对方收到 TCP可靠
  • Ubuntu20.10编译安装Python3.8

    1 更新软件包列表并安装构建Python所需的软件包 xff1a sudo apt update sudo apt install build essential zlib1g dev libncurses5 dev libgdbm dev
  • VINS-Fusion-RGBD编译错误

    error 39 SHAPE CROSS 39 is not a member of 39 cv 39 error 39 SHAPE RECT 39 is not a member of 39 cv 39 error 39 TERMCRIT
  • win10 WSL2 AirSim 仿真环境搭建

    win10 WSL2 AirSim 仿真环境搭建 wsl2AirSim安装教程基本环境安装WSL2安装PX4 编译环境配置好默认的工具链下载编译PX4 安装AirSim环境安装虚幻引擎下载AirSimLandscapeMountains下载
  • C语言实现UDP通信

    UDP通信 UDP是一种无连接的尽最大努力交付的不可靠连接 xff0c 通信之前无需先建立连接 xff0c 自然而然 xff0c 通信之后也就无需再释放连接 通信的套接字 UDP所采用的通信接口与前面讲过的TCP通信接口相同 xff0c 只
  • Github两个分支无法合并问题的解决与复现

    问题描述 xff1a 使用IDEA的git初始化仓库后 xff0c 提交到github空仓库时 xff0c 出现master分支无法和默认的main分支合并的情况 解决思路 xff1a 在已经有两个分支的情况下 xff0c 将两个分支克隆到
  • 常见算法题型,通常算法求解步骤

    算法题型 xff1a 排序 查找 字符串匹配 图 组合 几何 数值 算法求解步骤 xff1a xff08 仅仅为个人理解 xff09 1 分析问题 xff0c 建立模型 理解题目 xff0c 属于哪一类题型 xff0c 与哪类题型类似 2
  • Freertos学习

    FreeRtos小问题 初步了解FreeRTOS xff0c 学习原子哥的视频 遇到问题总结 xff1a 1 freertos的一个 start task 的子任务是不是同时运行的 xff1f 不是 xff0c CPU一次只能处理一个任务
  • vector的介绍及使用(12)

    目录 1 vector的介绍 2 vector的使用 1 vector的定义 2 vector的迭代器使用 3 vector空间增长问题 4 vector的增删查改 5 遍历 1 下标 43 遍历 2 迭代器遍历 3 范围for遍历 6 注
  • STM32F103最小系统图例

    一 STM32F103最小系统 1 最小系统的构成2 连接图3 电源电路4 复位电路5 时钟电路6 程序下载电路7 启动配置电路 1 最小系统的构成 单片机芯片 供电电路 时钟电路 复位电路 程序下载电路 启动配置电路 2 连接图 3 电源
  • T265学习之路(2)---T265源码下载及案例实验

    一 T265 源码下载 在安装好Realsense viewer进行测试后 xff0c 需要根据不同需求来读取传感器数据 xff0c 而想对T265入门 xff0c 对源码的解读和使用是最快也是最高效的学习方法 xff0c 因此先从Gith
  • 【cmake学习】cmake 引入第三方库(头文件目录、库目录、库文件)

    程序的编写需要用到头文件 xff0c 程序的编译需要lib文件 xff0c 程序的运行需要dll文件 xff0c 因此cmake引入第三方库其实就是将include目录 lib目录 bin目录引入工程 目录 1 find package x