ubuontu16.04安装Opencv库引发的find_package()错误信息处理及其简单使用
在安装完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