程序的编写需要用到头文件,程序的编译需要lib文件,程序的运行需要dll文件,因此cmake引入第三方库其实就是将include目录、lib目录、bin目录引入工程。
目录
1、find_package(批量引入库文件和头文件)
2、include_directories(引入头文件目录)
3、link_libraries(引入库文件目录)
4、target_link_libraries(引入库文件到子工程)
1、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_libraries(引入库文件目录)
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、target_link_libraries(引入库文件到子工程)
target_link_libraries 表示添加第三方 lib 库文件到目标工程,该lib库文件必须能在搜索路径中找到。link_libraries 和 target_link_libraries区别如下:
- link_libraries:向总工程添加库目录的搜索路径
- target_link_libraries:子工程需要用到哪个lib库文件,需要使用 target_link_libraries 指定。(该lib库文件必须能在搜索路径中找到)
link_libraries(子工程名 库文件1 库文件2 ...) # 注意子工程名和库文件名之间以空格隔开
add_executable(qt_test ${ALL_SRCS}) # 子工程名是 qt_test
# 绝对路径引入
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")
link_libraries(qt_test
${LIB_FFMPEG}
)
# 预定义变量引入
# PROJECT_SOURCE_DIR 是cmake的预定义变量,表示顶层CmakeList文件所在路径
link_libraries(qt_test
${PROJECT_SOURCE_DIR}/ExtLib/ffmpeg/win64/lib/avcodec.lib
)