FIND_PACKAGE()是如何工作的?

官方文档: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()是如何工作的?

【找了一天之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文件中又有如下定义:

  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