欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识！
您现在的位置是： 首页  >  科技

ubuontu16.04安装Opencv库引发的find_package()错误信息处理及其简单使用

程序员文章站 2022-08-10 11:13:08
在安装完Opencv库之后，打算测试一下Opencv库是否成功安装。下面是用的例子对应的.cpp代码以及对应的CMakeLists.txt代码: .cpp文件： CMakeLists.txt文件： 在工程目录下新建并进入build目录，然后输入命令:cmake ..之后出现如下错误信息: 根据它的提 ......

　　在安装完Opencv库之后，打算测试一下Opencv库是否成功安装。下面是用的例子对应的.cpp代码以及对应的CMakeLists.txt代码:

.cpp文件：

 1 #include <stdio.h>
 2 #include <opencv2/opencv.hpp>
 3 using namespace cv;
 4 int main(int argc, char** argv )
 5 {
 6   if ( argc != 2 )
 7   {
 8     printf("usage: DisplayImage.out <Image_Path>\n");
 9     return -1;
10   }
11   Mat image;
12   image = imread( argv[1], 1 );
13   if ( !image.data )
14   {
15     printf("No image data \n");
16     return -1;
17   }
18   namedWindow("Display Image", WINDOW_AUTOSIZE );
19   imshow("Display Image", image);
20   waitKey(0);
21   return 0;
22 }

CMakeLists.txt文件：

1 cmake_minimum_required(VERSION 2.8)
2 project(DisplayImage)
3 find_package( Opencv  REQUIRED)
4 if(Opencv_FOUND)
5     message(STATUS "The Opecv lib is found!") 
6 endif()
7 add_executable( Display test.cpp)
8 arget_link_libraries( Display ${OpenCV_LIBS} )

在工程目录下新建并进入build目录，然后输入命令:cmake ..
之后出现如下错误信息:

CMake Error at CMakeLists.txt:5 (find_package):
  By not providing "FindOpencv.cmake" in CMAKE_MODULE_PATH this project has
  asked CMake to find a package configuration file provided by "Opencv", but
  CMake did not find one.

  Could not find a package configuration file provided by "Opencv" with any
  of the following names:

    OpencvConfig.cmake
    opencv-config.cmake

  Add the installation prefix of "Opencv" to CMAKE_PREFIX_PATH or set
  "Opencv_DIR" to a directory containing one of the above files.  If "Opencv"
  provides a separate development package or SDK, be sure it has been
  installed.

　　根据它的提示，发现cmake 没有找到FindOpencv.cmake文件，之后尝试去找OpencvConfig.cmake。 结果也没有找到。这个就是我们解决问题的突破口。首先我在系统根目录下尝试搜索FindOpencv.cmake，也尝试寻找OpencvCongfig.cmake 结果都没有找到。实际上库的作者都会提供这两个文件，但是我按照Opencv官网上的安装说明编译安装的Opencv库。仍然没有找到。具体原因还不太清楚。于是我在编译好的Opecnv文件的build的目录里面找到了OpenCVConfig.cmake 在/usr/local/share/OpenCV这个目录下同样找到了OpenCVConfig.cmake文件。虽然找到了类似的文件，仍然没有实质性的解决问题。于是我在网上搜索了关于find_package（）命令的有关使用。下面简单介绍Cmake 如何使用find_package命令对外部库进行查找。最后提出解决上面cmake ..出现问题的解决方案。
find_package使用简介:
　　首先明确一点，cmake本身不提供任何关于搜索库的便捷方法，也不会对库本身的环境变量进行设置。它仅仅是按照优先级顺序在指定的搜索路径进行查找Findxxx.cmake文件和xxxConfig.cmake文件(其中xxx代表库的名字，特别注意的是有大小写之分)，这两个文件大体上是没有区别的，cmake能够找到这两个文件中的任何一个，我们都能成功使用该库，也就是我们可以用库的内置好了Cmake变量。包含了库的头文件和库文件的路径信息，虽然库的作者一般会提供这两个文件，但是也会遇到安装完毕后找不到的情况。当我们在cmake..命令之后，Cmake 会读取执行CMakeLists.txt中的代码，当执行find_package()这条命令后,Cmake 就会从某些路径中找这Findxxx.cmake文件或者xxxConfig.cmake文件，Cmake找到任意一个之后就会执行这个文件，然后这个文件执行后就会设置好一些Cmake变量。比如下面的变量（NAME表示库的名字 比如可以用Opencv 代表Opencv库）:

<NAME>_FOUND
<NAME>_INCLUDE_DIRS or <NAME>_INCLUDES
<NAME>_LIBRARIES or <NAME>_LIBRARIES or <NAME>_LIBS
<NAME>_DEFINITIONS

一般常用的就是xxx_FOUND 、xxx_INCLUDE_DIRS、xxx_LIBS，分别代表是否找到库的标志、库的头文件路径、库文件路径。find_package()有两种模式:Module模式和Config模式，分别对应上面的Findxxx.cmake 和xxxConfig.cmake两个文件。cmake默认优先Module模式，而Config模式是备选项。

Module模式(仅仅查找Findxxx.cmake文件):
Cmake会优先搜索CMAKE_MODULE_PATH指定的路径,如果在CMakeLists.txt中没有设置CMAKE_MODULE_PATH为存储Findxxx.cmake的路径，也就是说没有下面的指令：
set(CMAKE_MODULE_PATH "Findxxx.cmake文件所在的路径")
那么Cmake不会搜索CMAKE_MODULE_PATH指定的路径，此时Cmake会搜索第二优先级的路径，也就是<CMAKE_ROOT>/share/cmake-x.y/Mdodules （注意:x.y表示版本号。我的是3.10）。其中CMAKE_ROOT是你在安装Cmake的时候的系统路径，因为我并没有指定安装路径，所以是系统默认的路径，在我的系统中(ubuntu16.04)系统的默认路径是/usr/loacl，如果你在安装的过程中使用了
cmake -DCMAKE_INSTALL_PREFIX=自己dir路径 ，那么此时CMAKE_ROOT就代表那个你写入的路径 。刚刚说道第一优先级的路径搜索没有找到Findxxx.cmake文件，就会到第二优先级的路径下搜索。如果Cmake在两个路径下都没有找到Findxxx.cmake文件。那么Cmake就会进入Config模式。

Config模式（仅仅查找xxxConfig.cmake文件）：
Cmake会优先搜索xxx_DIR 指定的路径。如果在CMakeLists.txt中没有设置这个cmake变量。也就是说没有下面的指令:
set(xxx_DIR "xxxConfig.cmkae文件所在的路径")
那么Cmake就不会搜索xxx_DIR指定的路径，此时Cmake 就会自动到第二优先级的路径下搜索，也就是/usr/local/lib/cmake/xxx/中的xxxConfig.cmake文件。
上面主要讲了Cmake的搜索模式。如果Cmake在两种模式提供的路径中没有找到对应的Findxxx.cmake和xxxConfig.cmake文件，此时系统就会提示最上面的那些错误信息。

问题分析：
回顾一下上面的错误信息。根据提示以及上面的两种模式的说明，可以发现我的CMakeLists.txt文件中没有加入设置CMKAE_MODULE_PATH以及Opencv_DIR的命令，那么也就是说Cmake执行find_package后，会自动到两种默认的第二优先级的搜索路径下搜索Findxxx.cmake 和xxxConfig.cmake文件。虽然我在安装Opencv的时候，是默认安装系统目录的，但是我在Moudule模式中的第二优先级搜索路径<CMAKE_ROOT>/share/cmake-x.y/Mdodules里面没有发现FindOpencv.cmake文件。然后我在Config模式中的第二优先级搜索路径/usr/loacl/lib/cmake/中也没有发现Opencv文件夹，更没有找到OpencvConfig.cmake文件了。而是仅仅看到了我之前在系统上安装的Pangolin文件夹，里面确实有对应的PangolinConfig.cmake文件。但是我在/usr/local/share/OpenCV/文件夹中找到了OpenCV.cmake文件。但不是最上面错误信息中提到的OpencvConfig.cmake文件。仅仅是大小写不同。

解决方案:
(1)、我们可以忽略上面的错误信息，因为我们用find_package()查找库的目的是，就是为了用include_directories()包含头文件。用link_directories()包含库文件。最后用target_link_libraries(可执行文件 库)链接动态或者动态的库,所以最简单的方法就是自己在Opencv包的目录下找到头文件路径和库文件路径。可以在CMakeLists.txt中设置如下指令:

1 set(Opencv_INCLUDE_DIRS "Opencv库的头文件目录")
2 set(Opencv_LIBRARIES_DIRS "Opencv库的库文件目录")
3 set(Opencv_LIBs "具体的链接库文件.a  .so")
4 include_directories(${Opencv_INCLUDE_DIRS})
5 link_directories(${Opencv_LIBRARIES_DIRS})
6 target_link_libraries( <执行文件名字>   "${Opencv_LIBs} )

这里有一点不好的地方就是指令的 "" 部分。前两条指令还可以，我们只要写下具体的文件路径就行了。对于第三条指令。具体链接库的文件 这个就很多了，而且很有可能我们写入的不全，好的情况是我们没有用那么多的库，所以简单的程序可能正常编译运行，但是当程序复杂的时候，所需要的库就不是我们能够考虑到的，我们就必须要把所有可能的库都加入到这里来，只要漏掉了工程需要的库文件或者头文件，都会导致程序编译失败。这是一个致命的缺点。当然对于我自己的情况，我的安装包默认安装到了系统目录，也就是说我可以不添加头文件和库文件路径，仅仅设置下一具体的链接库文件 即以.so .a结尾的文件集。如果你安装到了其他的地方，那么就需要设置包含库文件和头文件的路径。
"Opencv库的头文件目录" 这个路径的选择有两个。一个是安装包的下的include目录，一个是/usr/local/include
"Opencv库的库文件目录" 这个路径的选择有两个。一个是安装包的build/bin，一个是/usr/local/lib
"具体的链接库文件" 这个路径的选择有两个。一个是安装包的build/bin/所有库文件名字，一个是/usr/local/lib下的所有库文件名字 （注意:这个"具体的链接库文件"怎么能够简单的写出来我还不太清楚，仅仅知道把所有文件写出来，如果有人知道简化写，可以给我留言）

(2)、第一种方法虽然回避了上面错误信息的发生，但是在后面也需要做很多的工作。每一步的工作不到位，都可能会导致编译失败。接下来的方法就是按照上面提示的信息寻找需要的FindOpencv.cmake和OpencvConfig.cmake文件。在问题分析里面讨论了，在我的cmake默认的搜索路径中没有包含上面的任何一个文件。仅仅在Opencv安装包和/usr/local/share/OpenCV这两个路径下找到了OpenCV.cmake文件。接下来的操作有四种选择（需要注意的是我的Opencv库默认安装到了系统目录，所以在CMakeLists.txt没有加入包含头文件和库文件的两条指令。）:
一、让系统按照Module模式进行查找，也就是想办法弄出一个FindOpencv.cmake文件，之后设置一下CMAKE_MODULE_PATH变量。下面是具体操作:因为我们在所有目录中没有找到FindOpencv.cmake文件。只能找到OpenCVConfig.cmake文件。我们可以将这个文件名字更改为FindOpencv.cmake（更改方法有很多，如果没有权限可以鼠标右键更改，如果有权限那么必须在命令行中sudo 进行更该）。然后在CMakeLists.txt中加入CMAKE_MODULE_PATH的路径信息。因为OpenCVConfig.cmake文件出现的位置有两个，一个是安转包的build/下，一个是/usr/local/share/OpenCV/下。我选择的是在安转包的build/下面直接鼠标右键更改。更改完毕后在CMakeLists.txt中find_package命令前面加入下面命令:
set(CMAKE_MODULE_PATH /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
最后的CMakeLists.txt中的命令如下:

1 cmake_minimum_required(VERSION 2.8)
2 project(DisplayImage)
3 set(CMAKE_MODULE_PATH  /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
4 find_package( Opencv  REQUIRED)
5 if(Opencv_FOUND)
6    message(STATUS "The Opecv lib is found!") 
7 endif()
8 add_executable( Display test.cpp)
9 target_link_libraries( Display ${OpenCV_LIBS} )

二、让系统按照Config模式进行查找，想办法弄出一个OpencvConfig.cmake文件，之后设置一下Opencv_DIR变量（这里一定是Opencv_DIR 不能是OpenCV_DIR）。下面是具体操作:因为我们在所有目录中没有找到OpencvConfig.cmake文件。只能找到OpenCVConfig.cmake文件。我们可以将这个文件名字更改为OpencvConfig.cmake（具体的更改方法参照上面）。然后在CMakeLists.txt中加入Opencv_DIR的路径信息。因为OpenCVConfig.cmake文件出现的位置有两个，一个是安转包的build/下，一个是/usr/local/share/OpenCV/下。我选择的是在安转包的build/下面直接鼠标右键更改。更改完毕后在CMakeLists.txt中find_package命令前面加入下面命令:
set(Opencv_DIR /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
最后的CMakeLists.txt中的命令如下:

1 cmake_minimum_required(VERSION 2.8)
2 project(DisplayImage)
3 set(Opencv_DIR  /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
4 find_package( Opencv  REQUIRED)
5 if(Opencv_FOUND)
6    message(STATUS "The Opecv lib is found!") 
7 endif()
8 add_executable( Display test.cpp)
9 target_link_libraries( Display ${OpenCV_LIBS} )

三、让系统按照Module模式进行查找，将OpenCVConfig.cmake文件更改为FindOpenCV.cmake,之后设置一下CMAKE_MODULE_PATH路径信息，之后在find_package的时候指定一个名字，比如:find_package(Opencv NAMES OpenCV REQUIRED )。此时find_package就会查找FindOpenCV.cmake文件，下面是具体操作:因为我们在所有目录中没有找到FindOpencv.cmake文件。只能找到OpenCVConfig.cmake文件。我们可以将这个文件名字更改为FindOpenCV.cmake,然后在CMakeLists.txt中加入CMAKE_MODULE_PATH的路径信息。因为OpenCVConfig.cmake文件出现的位置有两个，一个是安转包的build/下，一个是/usr/local/share/OpenCV/下。我选择的是在安转包的build/下面直接鼠标右键更改。更改完毕后在CMakeLists.txt中find_package命令前面加入下面命令:
set(CMAKE_MODULE_PATH /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
并且修改find_package内容，具体命令如下：
find_package( Opencv NAMES OpenCV REQUIRED)
最后的CMakeLists.txt中的命令如下:

1 cmake_minimum_required(VERSION 2.8)
2 project(DisplayImage)
3 set(CMAKE_MODULE_PATH  /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
4 find_package( Opencv  NAMES OpenCV REQUIRED)#或者用find_package(OpenCV REQUIRED)
5 if(Opencv_FOUND)
6    message(STATUS "The Opecv lib is found!") 
7 endif()
8 add_executable( Display test.cpp)
9 target_link_libraries( Display ${OpenCV_LIBS} )

四、让系统按照Config模式进行查找，设置一下Opecv_DIR路径，之后在find_package的时候指定一个名字，比如:find_package(Opencv NAMES OpenCV REQUIRED )。或者显示的指出用Config模式即
find_package(Opencv CONFIGS NAMES OpenCV REQUIRED)，因为OpenCVConfig.cmake文件出现的位置有两个，一个是安转包的build/下，一个是/usr/local/share/OpenCV/下。我选择的是在安转包的build/路径对Opencv_DIR设置。更改完毕后在CMakeLists.txt中find_package命令前面加入下面命令:
set(Opencv_DIR /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
并且修改find_package内容，具体命令如下：
find_package( Opencv NAMES OpenCV REQUIRED)
最后的CMakeLists.txt中的命令如下:

1 cmake_minimum_required(VERSION 2.8)
2 project(DisplayImage)
3 set(Opencv_DIR  /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
4 find_package( Opencv  NAMES OpenCV REQUIRED)#或者用find_package(OpenCV REQUIRED)
5 if(Opencv_FOUND)
6    message(STATUS "The Opecv lib is found!") 
7 endif()
8 add_executable( Display test.cpp)
9 target_link_libraries( Display ${OpenCV_LIBS} )

总结:
你可以灵活的选择上面的两种方法中的任何一种，或者是第二中方法中的任何一种方式。任何一种写法。实际上上面的过程中会有很多的细节，可以自己一一尝试，看看输出的内容到底是什么。find_package具体用法可以参考cmake官方手册。下面将上面的四种方式写的CMakeLists.txt，结合在一起进行对比(默认对应上面四种方式相应的更改了OpenCVCongfig.cmake文件）:

 1 cmake_minimum_required(VERSION 2.8)
 2 project(DisplayImage)
 3 
 4 #设置Module模式路径(想要使用的话前提要求有FindOpencv.cmake或者FindOpenCV.cmake,之后选择对应的find_package模式，例如FindOpencv.cmake 对应find_package(Opencv REQUIRED)，FindOpenCV.cmake对应find_package(Opencv NAMES OpenCV REQUIRED) )
 5 #set(CMAKE_MODULE_PATH  /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
 6 #设置Config模式路径(想要使用的话,前提要有OpencvConfig.cmake或者OpenCVConfig.cmake，之后选择对应的find_package模式，对应关系与Moudule模式同理，需要注意的一点是，我们也可直接显示的使用Config模式，即Cmake不会按照Module模式进行查找。需要调用find_package(Opencv CONFIGS NAMES OpenCV REQUIRED)或者find_package(Opencv CONFIGS REQUIRED))
 7 set(Opencv_DIR  /home/gcj/Slam_Start/slam_directory/slam_packages/opencv-3.4.0/build)
 8 
 9 #对应FindOpenCV.cmake和OpenCVConfig.cmake
10 find_package( Opencv  NAMES OpenCV REQUIRED)#或者用find_package(OpenCV REQUIRED)
11 
12 #对应FindOpencv.camke和OpencvConfig.cmake
13 find_package( Opencv REQUIRED)
14 
15 if(Opencv_FOUND)
16    message(STATUS "The Opecv lib is found!") 
17 endif()
18 
19 #下面两个包含头文件路径的命令，可以选择性的添加。因为我默认安装到了系统目录中，所以即使不添加下面的命令，系统也能够默认搜索到头文件。如果你安装这个库到了其他地方，那么下面这句话就是必须的。
20 #添加包含头文件的路径
21 #include_directories(${OpenCV_INCLUCE_DIRS})
22 
23 #增加可执行文件
24 add_executable( Display test.cpp)
25 
26 #链接库文件 这个命令是必须的。尤其是${OpenCV_LIBS}是在cmake找到对应的xxxConfig.cmake或者Findxxx.cmake后执行.cmake文件后定义的Cmake变量。注意OpenCV是大写的，因为.cmake文件中仅仅定义了大写的OpenCV_LIBS变量。所以在具体的写其他库的时候，要注意是大写还是小写，可以到相应的.cmake文件中查看。
27 target_link_libraries( Display ${OpenCV_LIBS} )

上面的理解可能不全面，更进一步的理解可以查阅下面的参考资料，如果您有更好的理解，或者上面讲解过程中有错误，希望您指出，谢谢！

参考资料：
1、http://blog.csdn.net/bytxl/article/details/50637277#t0
2、https://cmake.org/cmake/help/v3.10/command/find_package.html
3、https://*.com/questions/8711109/could-not-find-module-findopencv-cmake-error-in-configuration-process

上一篇： 使用PDF.JS实现pdf文件在线预览时，报文件被损坏的错误

下一篇： 唐朝郭元振人物生平简介，轶事趣闻

推荐阅读