2. it技术
  3. CMakeList.txt中FIND

CMakeList.txt中FIND

it2024-08-04  62

官方文档：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】

结果是第七条：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中，如果不在CMakeList.txt文件中手动修改变量OpenCV_DIR的值或将其设置为空，则该值可能一直存在并导致无法让CMake找到其他安装位置、其他版本的OpenCV。

最新回复(0)