CMakeLists.txt中FIND_PACKAGE()是如何工作的？

原创 已于 2022-07-05 19:54:21 修改 · 2.5k 阅读 · 12 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
标签
#cmake #opencv
于 2020-10-21 17:21:16 首次发布
本文详细介绍了CMake中FIND_PACKAGE命令的两种模式：Module模式和Config模式，并以OpenCV和Eigen为例，解释了如何通过这两种模式定位头文件和库文件路径。

官方文档：https://cmake.org/cmake/help/latest/command/find_package.html

FIND_PACKAGE(<PackageName>)如何查找头文件和库文件路径？
有两种模式：Module模式和Config模式。

1. Module模式

该模式通过寻找Find<PackageName>.cmake文件，由该文件找到对应的库以及路径。
Find<PackageName>.cmake文件负责查找包、检查版本、提供任何所需的消息。
查找Find<PackageName>.cmake文件有两种方式：

  1. 首先，通过CMAKE_MODULE_PATH变量指定的目录查找。
  2. 其次，在<cmake安装目录>/Modules文件夹内查找。
    ubuntu默认cmake安装在/usr/share/cmake-3.16目录。

如果没有找到对应的.cmake文件，则进入Config模式。如果指定了MODULE选项，则只在Module模式下寻找。

2. Config模式

该模式查找<PackageName>Config.cmake或<lower-case-package-name>-config.cmake文件。cmake会创建<PackageName>_DIR 变量存储含有上述文件的路径。
如果.cmake文件未找到，会生成错误信息。
可以手动设置<PackageName>_DIR，如果对应的路径中没有.cmake文件，则会忽略该路径。

查找过程：

对于要查找的包，CMake生成一组可能的安装路径前缀<prefix>，对于每个<prefix>，将查找以下路径：

  • <prefix>/ (W)
  • <prefix>/(cmake|CMake)/ (W)
  • <prefix>/<name>*/ (W)
  • <prefix>/<name>*/(cmake|CMake)/ (W)
  • <prefix>/(lib/<arch>|lib*|share)/cmake/<name>*/ (U)
  • <prefix>/(lib/<arch>|lib*|share)/<name>*/ (U)
  • <prefix>/(lib/<arch>|lib*|share)/<name>*/(cmake|CMake)/ (U)
  • <prefix>/<name>*/(lib/<arch>|lib*|share)/cmake/<name>*/ (W/U)
  • <prefix>/<name>*/(lib/<arch>|lib*|share)/<name>*/ (W/U)
  • <prefix>/<name>*/(lib/<arch>|lib*|share)/<name>*/(cmake|CMake)/ (W/U)
    其中W代表Windows系统，U代表UNIX系统。这只是惯例，实际上在Windows或UNIX系统上述所有路径都会搜索到。

关于如何生成<prefix>，官方文档给出了九条说明：
在这里插入图片描述

FIND_PACKAGE(OpenCV REQUIRED)命令如何找到OpenCV？

由第7条说明中的变量：CMAKE_SYSTEM_PREFIX_PATH，它包含以下路径：

  • /usr

根据第五条前缀查询规则：<prefix>/(lib/<arch>|lib*|share)/cmake/<name>*/，cmake查找到了这个路径：

  • /usr/lib/x86_64-linux-gnu/cmake/opencv4

这也就是变量OpenCV_DIR的值。而该路径中的OpenCVConfig.cmake文件中又有如下定义：

  1. 设置变量OpenCV_INSTALL_PATH值为当前路径向上四层，即/usr目录
  2. 设置变量OpenCV_INCLUDE_DIRS值为${OpenCV_INSTALL_PATH}/include/opencv4

因此，CMakeList.txt文件中的变量OpenCV_INCLUDE_DIRS的值为/usr/include/opencv4


同理，在CMakeList.txt文件中加入：

  • SET(OpenCV_DIR /opt/opencv4.5.0/lib/cmake/opencv4)

则CMake查找到/opt/opencv4.5.0/lib/cmake/opencv4路径下的OpenCVConfig.cmake文件，该文件定义：

  1. 设置变量OpenCV_INSTALL_PATH值为当前路径向上三层，即/opt/opencv4.5.0目录
  2. 设置变量OpenCV_INCLUDE_DIRS值为${OpenCV_INSTALL_PATH}/include/opencv4

因此此时变量OpenCV_INCLUDE_DIRS的值为/opt/opencv4.5.0/include/opencv4

到这里，CMake终于找到了系统中的OpenCV。

*注意：当你曾经成功运行FIND_PACKAGE(OpenCV REQUIRED)命令并找到了opencv的安装路径，CMake就会将该路径存入变量OpenCV_DIR中，如果不手动清空变量OpenCV_DIR，则该值可能一直存在并指向某个版本的OpenCV的安装位置，导致无法让CMake找到其他安装位置、其他版本的OpenCV，亦或使你的CMakeList.txt中的错误被掩盖。我使用的两个方法是：1. 删除build文件夹重新生成；2.使用Clion中Tools | CMake | Reset Cache and Reload Project功能

FIND_PACKAGE(OpenCV REQUIRED)命令如何找到Eigen？

Eigen3Config.cmake文件位置：/usr/lib/cmake/eigen3/Eigen3Config.cmake

pla66
关注
CMakeLists学习一、find_package查找包
qq_41035283的博客
01-13 1万+
CMakeLists学习一、find_package查找包前言引例环境变量find_package查询路径设定查询路径默认路径链接库问题find_package()命令 前言 很久之前就想写关于CMakeLists相关的学习记录，但当时的重点在数学基础内容上，这一块就搁置了，现在重新记录一下。 首先就是cmake中查找第三方包指令find_package()的原理 引例 图像相关的工程中，最常用的第三方包OpenCV需要通过CMakeLists来配置，常见写法如下： find_package(OpenCV
【ROS】CMakeLists.txt文件解析
qq_52785580的博客
01-15 2170
这就是CMakeLists.txt文件的大部分主要功能的解析，其中还有一个generate_dynamic_reconfigure_options()函数没有说到，这个是根动态参数配置相关的，将会在介绍dynamic reconfigure的文章中说到。
解决CMake时的Find_Package失败问题
热门推荐
jinking01的专栏
01-03 1万+
今天在编译组内代码时遇到了Find_package问题，具体来说就是找不到redis的库及相关头文件。针对上述问题，我们查找并安装了class_loader的开发库，上述问题就解决了。也就是继续执行cmake，又出现了问题，找不到hiredis库使用前面的方法，发现安装hiredis的开发库之后，仍然报错。然后使用whereis查找hiredis对应的头文件和库。分别在/usr/include/hiredis下面和/usr/lib/x86_64-linux-gnu下面。然后重新执行cmake，成功。
“轻松搞定 CMake”系列之 find_package 用法详解
布袋和尚
01-13 1万+
在没有 CMake 的时代，这种库查找链接的工作都需要借助 MakeFile 中的各种命令来完成，非常的繁琐，而且不方便移植，到了 CMake 时代，CMake 给我们提供了 find_package() 命令用来查找依赖包，理想情况下，一句 find_package() 命令就能把一整个依赖包的头文件包含路径、库路径、库名字、版本号等情况都获取到，后续只管用就好了。所谓“找到”这些库，其实是根据我们的需要找到指定版本的库头文件包含路径、链接库路径等，从而能够满足我们开发项目的编译链接需要。
[ROS]（03）CMakeLists.txt详解
CynalFly的博客
07-16 3048
CMakelists.txt是用于编译软件包的CMake编译系统的输入文件，几乎可以在任何文本编辑器中进行编辑。该文件描述了如何编译代码以及安装到何处。用于catkin项目的文件是一个标准的附带一些额外约束的vanilla CMakelists.txt文件。...
CMake如何查找链接库---find_package的使用方法
上善若水
04-24 3634
如果编译软件使用了外部库，事先并不知道它的头文件和链接库的位置。得在编译命令中加上包含它们的查找路径。CMake使用 find_package（）命令来解决这个问题。本文讨论了find_package（）的工作原理。 一、find_package()的查找*.cmake的顺序： 1、 find_package()命令首先会在模块路径中寻找 Find.cmake，这是查找库的一个典型方式。具体查
ROS之CMakeLists.txt 文件
cookie909的博客
03-26 742
 http://blog.csdn.net/u013243710/article/details/35795841 http://wiki.ros.org/catkin/CMakeLists.txt  文件CMakeLists.txt是用于构建软件包的CMake构建系统的输入。任何符合cmake的包都包含一个或多个CMakeLists。txt文件描述如何构建代码并将其安装到何处。 结构和机制1. ...
ROS------Catkin编译系统
zjx624bjh的博客
07-27 1068
（1)产生： 之前在学校学校学习的时候，在Linux下习惯通过gcc g++生成makefile来编译文件，但接触了大型项目随着代码量的增多，便接触了更高层次的Cmake工具，加上ROS对Cmake的扩展，便出现了catkin编译工具。 （2)优点： 软件包编译后无需安装就可使用； 自动生成find_package()代码，pkg-config文件； 解决了多个软件包构建顺序问题； 一次配置...
【cmake开发（6）】Cmakelists 使用 gcc/g++指定版本，find_package 基本原理
AbiUni（YY熊）
09-22 2668
我们在《【cmake开发（5）】cmake 设置常规变量、环境变量、内置变量；cmake 带参数编译和 -D 选项；c++源码通过-D 选项的宏定义进行条件编译》 中提到了变量。
cmake 生成供find_package使用的自定义模块
沧海一帆的专栏
11-08 1万+
cmake中经常使用find_package寻找模块，使用起来非常方便．find_package的原理是什么呢？如果自己写个模块，如何提供给别人使用．如果别人希望用find_package的形式使用你的模块中的库，我该如何用cmake写这个库呢？ 下面用一个例子来说明： myapp程序通过find_package调用mylib中的库 1.myapp工程 myapp工程目录如下 . ├── CMak...
怎么将pom文件mysql驱动修改版本_pom.xml中的mysql坐标与操作的数据库版本不匹配，导致访问数据库报错问题...
weixin_32021363的博客
01-12 2976
1、修改pom.xml中的mysql版本2、如果标红的话，则下载资源3、修改mysql的驱动配置，如果是mysql5，则在druid.properties中配置驱动：driverClassName=com.mysql.jdbc.Driverurl=jdbc:mysql://192.168.4.77:3306/travelusername=rootpassword=rootinitialSize=5...
CMakeLists中find_package()的原理，多版本依赖并存方法
最新发布
DDS_____的博客
03-14 1869
有时候会遇到明明安装了某个库，但是find_package()找不到的情况，这里总结一下find_package 的基本流程和自定义搜索的方法。也经常遇到两个C++项目依赖存在冲突的情况，除了用docker外，还可以手动定义依赖的安装路径，避免冲突。
CMakeLists.txt：打印find_package变量；判断库文件路径设定是否正确；install文件设置
qq_41035283的博客
11-23 2909
安装目标文件：通过TARGETS关键字指定要安装的目标文件，并通过DESTINATION关键字指定目标文件的安装路径。这样，当我们使用make install命令时，构建生成的myapp可执行文件将被安装到bin目录下，myheader.h头文件将被安装到include目录下，而mydir目录及其下的文件将被安装到share/myapp目录下。在上面的示例中，install()命令指定了要安装的目标（即${EXECUTABLE_NAME}）和目标的安装路径（即/usr/local/bin）。
CMake4-指令4-2：find_package【用于查找并配置复杂的第三方软件包】【通过查找第三方库的.cmake的文件，并不是直接去找具体的动态库文件和头文件】【指定第三方库所在路径】
u013250861的博客
11-19 9256
用于查找包（通常是使用三方库），并返回关于包的细节（使用包所依赖的头文件、库文件、编译选项、链接选项等）与直接在指定搜索目录下搜索库不同，命令可以获取更多的信息，那么它的搜索方式也是与不一样，它有两种不同的搜索方式，因此在介绍这个命令的细节之前，先简单介绍一下（）和（）。
CMake Error at CMakeLists.txt: (FIND_PACKAGE)找不到ncnn包的解决方法
masteryi-0018的博客
02-27 1万+
CMake Error at CMakeLists.txt: (FIND_PACKAGE)找不到ncnn包的解决方法
CMakeLists.txt ----find_package
人面不知何处去
04-24 6773
在linux平台下编译程序的时候通常都会使用到CMakeLists.txt来制定编译规则, 在查找需要链接的lib时候, 通常会使用到find_package, 记录一下我之前用到的地方. find_package 之后, 最好到FindXXX.cmake中看一下,这个库是怎样使用的. 如果没有特殊指定这个文件的路径, 路径通常是"/usr/share/cmake-XXX/Modules/Fi...
cmake find_package 介绍
zhaohuaxicaishi的专栏
07-06 721
1.在 cmake 的编译体系中，package 用来指代一个依赖库，包括一些头文件、动态库、静态库等等，在 CMakeFileLists.txt 中通过find_package()命令可以很轻易实现find_package命令对外部库进行查找。 2.cmake本身不进行库的搜索，也不会进行环境变量的设置。它仅仅是按照优先级顺序在指定的搜索路径进行查找Findxxx.cmake文件（toolchain.cmake）和xxxConfig.cmake文件(其中xxx代表库的名字，特别注意的是有大小写之分)，.
cmake(7)：find_package命令详解
翔底的博客
10-20 1万+
1. 说明 cmake的find_package命令对于构建软件提供了极大的便利，虽然知道怎么使用已经能解决大部分问题，但是cmake支持哪些包？为什么它能找到需要的包？如果是自己编写的库，需要如何做才能使用该命令进行构建等原理性问题却始终困扰着我。 这篇文章参考cmake官方文档和网上前辈的文章记录自己对find_package命令的学习和分析。 1.1 cmake支持哪些包 理论上只要符合find_package命令的查找条件，能让该命令识别的包或者库都会被支持。在实际使用时，我们可以把这些包分成三类：
CMake学习笔记：搜索第三方库及头文件路径 find_package()命令
weixin_45824067的博客
05-22 4966
在实际开发过程中，经常不可避免的会使用到第三方开源库，这些开源库可能是通过apt-get install 命令自动安装到系统目录，也可能是由我们自己下载库的源码然后通过编译安装到指定目录的。不管哪种方式安装的库文件，如果我们需要在自己的项目中使用这些库，首先面临的第一个问题就是如何找到这些库。也就是说，根据我们的需要找到指定本版的库头文件包含路径、链接库路径等，从而能够满足我们开发项目的编译链接需要。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值