官方文档: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
文件有两种方式:
- 首先,通过
CMAKE_MODULE_PATH
变量指定的目录查找。 - 其次,在
<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
文件中又有如下定义:
- 设置变量
OpenCV_INSTALL_PATH
值为当前路径向上四层,即/usr
目录 - 设置变量
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
文件,该文件定义:
- 设置变量
OpenCV_INSTALL_PATH
值为当前路径向上三层,即/opt/opencv4.5.0
目录 - 设置变量
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