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

在Windows环境下,程序的编写需要用到头文件,程序的编译需要库文件 lib 文件,程序的运行需要 dll 文件,因此 cmake 引入第三方库其实就是将include目录、lib目录引入工程。引入第三方库的方式分为两种:

  • 手动引入:通过 include_directories 或 link_directories 手动引入相关头文件和库文件路径
  • 批量引入:先使用 find_package 找到 .cmake 或 .pc 文件,找到后相关的头文件和库文件路径会分别保存在指定变量中,如 XXX_LIBRARIES,此时再通过 include_directories 或 link_directories一键引入所有的库和头文件路径

目录

一、手动引入

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

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

二、批量引入

1、find_package(查找 .cmake )

2、pkg_check_modules(查找 .pc )


一、手动引入

手动引入需要自己获取到所有头文件路径以及库文件路径,然后再调用函数接口引入。

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

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)

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

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

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
)

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

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

  • include_directories:将头文件目录引入到当前工程
  • target_include_directories:将头文件目录针对性的引入到目标子工程(当前工程一般可以包含多个子工程)

二、批量引入

一键引入只需提供 .cmake 文件或 .pc 文件的完整搜索路径,若 cmake 生成器能找到对应的库,便会自动将所有的头文件路径和库文件路径分别装填到对应的变量。

  • 头文件路径装填到变量 XXX_INCLUDE_DIRS
  • 库文件路径装填到 XXX_LIBRARY_DIRS
  • 库文件名装填到变量 XXX_LIBRARIES 或 XXX_LIBS (可能包含了全路径)

注意:这里的 XXX 表示库名,不同库的变量会略微有所不同

1、find_package(查找 .cmake )

find_package 主要用于查找 .cmake 文件(详细使用可以参考: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、pkg_check_modules(查找 .pc )

pkg_check_modules 主要通过 .pc 文件引入整个库,该命令会解析指定的 .pc 文件,并将所需的编译和链接信息提取到 CMake 变量中,以便后续使用。

pkg_check_modules:pkg_check_modules 使用详解

内容概要:本文针对T型三电平逆变器在电网电压跌落条件下的低电压穿越(LVRT)问题,提出了一种结合改进电流解耦控制与直流侧中点电位平衡的综合控制策略。通过建立逆变器的数学模型,采用双二阶广义积分器(DSOGI)实现电网电压正负序分量的精确分离,并在此基础上设计自适应无功支撑与故障电流限幅控制,以满足LVRT对无功补偿和电流安全性的要求。为提升不对称故障下的动态性能,引入改进的正负序解耦电流控制方法,有效克服传统PI控制器在耦合干扰下的控制滞后问题。同时,结合零序电压注入法对中点电位进行主动调控,抑制中点电压漂移,保障系统长期稳定运行。整个控制方案在Simulink平台上完成建模与仿真验证,结果表明该方法在电网故障期间具有优良的动态响应特性、稳定的中点电位控制能力和可靠的并网运行性能。; 适合人群:具备电力电子、自动控制或新能源并网技术背景,从事逆变器控制算法开发、微电网系统集成或可再生能源发电系统研究的工程技术人员及高校研究生。; 使用场景及目标:①用于提升T型三电平逆变器在电网故障条件下的并网可靠性与电能质量;②为高比例新能源接入场景下的LVRT控制策略设计提供理论支撑与技术路径;③适用于需要实现高性能电流控制与中点电位稳定的工业级变流器控制系统开发。; 阅读建议:建议结合提供的Simulink仿真模型进行学习,重点剖析正负序分离、改进电流解耦控制环设计及中点电位平衡模块的协同工作机制,可通过设置不同类型的电网故障(如单相短路、两相短路)和调节控制参数开展对比实验,深入掌握各模块对系统整体性能的影响规律。
内容概要:本文针对不对称电网故障条件下T型三电平逆变器的低电压穿越(LVRT)问题,提出了一种多目标协同控制策略,并通过Simulink平台实现了系统仿真验证。该策略综合考虑了故障期间电网电压跌落应对、正负序电流的精确解耦控制以及直流侧中点电位稳定三大关键问题,构建了多层次、多目标协同控制架构。通过引入双二阶广义积分器(DSOGI)实现电网电压正负序分量的快速、准确分离,结合改进的正负序解耦电流控制环路设计,有效抑制负序电流对系统的影响并保障并网电能质量;同时,采用零序电压注入法实现中点电位主动平衡控制,解决了传统控制中电位漂移导致器件应力不均的问题。整体控制方案提升了逆变器在复杂不对称故障下的运行稳定性与可靠性。; 适合人群:从事电力电子、新能源并网、电力系统自动化等领域的科研人员与工程技术人员,以及具备一定Simulink仿真基础和电力系统分析能力的研究生或高年级本科生。; 使用场景及目标:①深入研究T型三电平逆变器在不对称电网故障下的动态响应特性与控制挑战;②掌握低电压穿越、正负序电流解耦控制、中点电位平衡等核心技术的协同设计方法与实现原理;③为高性能逆变器控制系统在实际工程中的设计、优化与仿真验证提供理论依据和技术参考。; 阅读建议:建议结合文中详细的控制策略理论分析与Simulink模型结构图进行对照学习,重点关注双二阶广义积分器、正负序电流环设计、零序电压注入模块及SVPWM调制单元的实现细节,通过调整仿真工况并分析实验结果,深入理解各控制环节的协同作用机制与系统整体性能表现。
内容概要:本文研究了一种基于阶跃响应的V-Tiger自动增益调整PID控制器优化方法,旨在通过Matlab代码实现对PID控制器参数的智能化自动整定。文章系统阐述了PID控制的核心性能指标、V-Tiger自动增益控制器的技术原理以及阶跃响应整定的基础理论,提出了一种融合阶跃响应特征提取与多目标协同优化策略的自动整定方案,并引入自适应迭代校正机制以提升控制精度与系统鲁棒性。所提方法通过采集被控对象的阶跃响应曲线,提取关键动态特征参数,结合多目标优化算法实现比例、积分、微分增益的协同寻优,有效解决了传统手动整定效率低、适应性差的问题。仿真实验结果表明,该方法在动态响应速度、抗干扰能力及系统稳定性方面均表现出优越性能,具有较强的工程应用价值。; 适合人群:具备自动控制理论基础和Matlab编程能力,从事控制工程、自动化、电气工程及相关领域的科研人员、工程师以及高校研究生。; 使用场景及目标:①适用于工业过程控制、电机驱动、电力电子变换器等需高精度PID参数整定的实际工程场景;②目标在于实现PID控制器的智能化、自动化参数整定,降低对专家经验的依赖,减少人工调试成本,提升控制系统的动态响应品质与运行稳定性;③为科研工作者提供一套可复现、可扩展的Matlab代码框架,便于开展后续算法改进与工程化应用研究。; 阅读建议:建议读者结合文中理论推导与提供的Matlab代码进行同步学习,重点关注阶跃响应特征提取方法与多目标优化策略的设计逻辑,通过仿真实验对比不同整定方法的控制效果,深入理解V-Tiger算法的工作机制及其在复杂控制系统中的应用技巧。
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值