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沒有加入包含頭文件和庫文件的兩條指令。）:
1、讓系統按照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} )

2、讓系統按照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} )

3、讓系統按照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} )

4、讓系統按照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} )

上面的理解可能不全面，更進一步的理解能夠查閱下面的參考資料，若是您有更好的理解，或者上面講解過程當中有錯誤，但願您指出，謝謝！

參考資料：一、http://blog.csdn.net/bytxl/article/details/50637277#t0二、https://cmake.org/cmake/help/v3.10/command/find_package.html三、https://stackoverflow.com/questions/8711109/could-not-find-module-findopencv-cmake-error-in-configuration-process