ubuntu-18.04上cmake编译安装Opencv-4.2库及contrib扩展库
前言：此篇介绍在ubuntu下安装opencv库及opencv_contrib库，其编译依赖cmake，因此需先下载安装cmake，后续将进阶到ARM开发板上，并进行opencv图像处理相关开发如人脸识别等。
$开头代表linux命令
1. Cmake的编译及安装
Cmake的安装有两种方式（二选一）：1.apt-get命令安装（推荐）、2. 源码安装。
1.1 apt-get命令安装(推荐)
命令安装：
$ sudo apt-get install cmake
$ cmake --version // 查看版本，检测是否安装成功
备注：
Ubuntu需联网，若安装失败，可采用以下编译源码方式安装
若成功，则可跳过源码安装方式
1.2 编译源码安装
若apt-get方式安装成功，则跳过此步！
下载cmake
到官网下载：Download | CMake
本实验版本：cmake-3.17.0.tar.gz
解压：
将压缩包放于ubuntu某一目录下，进行解压：
$tar zxvf cmake-3.17.0.tar.gz
得到解压后的源码目录：cmake-3.17.0
编译及安装：
进入源码目录：
$ cd cmake-3.17.0/
首先读说明文档README.rst，里面有介绍如何配置/编译/安装，连命令都给出了：
$ ./bootstrap && make &&sudo make install
分别为：配置、编译、安装（采用默认配置值）
$ cmake --version // 查看版本，检测是否安装成功
最终，查看版本有版本信息输出才算成功：
zengzr@zengzr-ubu:~$ cmake --version
cmake version 3.5.1
CMake suite maintained and supported by Kitware (kitware.com/cmake).2. 安装依赖库
执行命令：
$ sudo apt-get install build-essential libgtk2.0-dev libavcodec-dev libavformat-dev libjpeg-dev libtiff5-dev libswscale-dev pkg-config
【补充】：
显示图像imshow()，正常显示几秒后报错：
Gtk-Message: 11:37:50.847: Failed to load module "canberra-gtk-module"缺少库，执行以下命令安装：
$ sudo apt-get install libcanberra-gtk-module
安装opencv_contrib依赖库:
执行命令：
$ sudo apt-get install python-dev python-numpy libtbb2 libtbb-dev libjpeg-dev libpng-dev libtiff-dev libdc1394-22-dev git
若报错：” E: 有几个软件包无法下载，要不运行 apt-get update 或者加上 --fix-missing 的选项再试试?”，则尝试下更新服务器软件信息，再重新安装：
$ sudo apt-get update
注：
原本是用libtiff4-dev的，但出错了并提示用libtiff5-dev，那就用它。
所需依赖库较多，请务必要采用apt-get方式，需联网。
3. Opencv的编译及安装
步骤如下：
3.1 下载opencv
OpenCV官网：Releases - OpenCV
Github官方：GitHub - opencv/opencv: Open Source Computer Vision Library
实验版本：opencv-4.2.0.zip
3.2 解压：
将源码包放到Ubuntu某目录下（如/data目录下），解压
$unzip opencv-4.2.0.zip
得到解压目录：opencv-4.2.0
编译准备
进入解压后的目录opencv-4.2.0，创建编译目录build并进入(编译过程产生的文件放于此编译目录下)：
$ cd opencv-4.2.0/
$ mkdir build && cd build
3.3 编译选项配置
首先，大概读下根CMakeList.txt（在opencv-4.2.0根目录），里面有关编译配置的信息：
Cmake相关、编译器及平台架构、三方依赖库、编译配置、安装配置…等。
先配置编译选项：（在build目录下操作）
$ cmake -D CMAKE_BUILD_TYPE=Release -D OPENCV_GENERATE_PKGCONFIG=YES -D CMAKE_INSTALL_PREFIX=/usr/local/opencv4 ../
CMAKE_BUILD_TYPE ---指定编译发布版本
OPENCV_GENERATE_PKGCONFIG ---生成opencv4.pc文件，支持pkg-config功能
CMAKE_INSTALL_PREFIX---指定安装路径为/usr/lib/opencv4（若不指定则默认/usr/local）
../---指定根CMakeList.txt文件路径，在opencv-4.2.0根目录（../表示上一级）
配置成功后，最终输出：
-- Install to: /usr/local/opencv4
-- -----------------------------------------------------------------
--
-- Configuring done
-- Generating done
-- Build files have been written to: /data/open_source/opencv-4.2.0/buildPS:过程会下载ippicv_2019_lnx_intel64_general_20180723.tgz等包，注意联网
若下载失败：暂忽略，未发现有影响。
3.4 编译
$ make
编译时间较长，耐心等候…
直到输出如下：
[100%] Linking CXX executable ../../bin/opencv_version
[100%] Built target opencv_version编译完成，进度条去到100%
3.5 安装
$ sudo make install
即安装到CMAKE_INSTALL_PREFIX指定目录下
$ ls /usr/local/opencv4/
bin include lib share
3.6 测试
进入源码目录samples/cpp/example_cmake路径下的示例：
$ cmake ./
报错：
Could not find a package configuration file provided by "OpenCV" with any
of the following names:
OpenCVConfig.cmake
opencv-config.cmake
…3.7 配置环境
以上出现错误，是因为没配置好编译及运行环境；
方式一：手动指定库
根据错误信息，是找不到xxx.cmake文件，在库的安装路径的lib/cmake/opencv4有这两个文件，手动指定（在samples/cpp/example_cmake路径下CMakeLists.txt中find_package()前面添加）：
set(OpenCV_DIR /usr/lib/opencv/lib/cmake/opencv4)再重新编译：
$ cmake ./
$ make
最终会生成可执行文件：opencv_example
方式二：将配置到系统环境（建议）
由于编译配置了OPENCV_GENERATE_PKGCONFIG=YES
因此，会在库的安装路径下生成opecv4.pc文件，
即：/usr/local/opencv4/lib/pkgconfig/opencv4.pc
在/etc/ld.so.conf.d/目录下创建opencv.conf，并写入库的路径：
$ sudo vi /etc/ld.so.conf.d/opencv.conf
将以下行写入opencv.conf文件并保存：
/usr/local/opencv4/lib
执行命令使其生效：
$ sudo ldconfig
配置bash:
在/etc/bash.bashrc的末尾加上以下两行：
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/opencv4/lib/pkgconfig
export PKG_CONFIG_PATH注：/usr/local/opencv4/lib/pkgconfig为opecv4.pc文件的路径
再使其生效：
$ source /etc/bash.bashrc
可用以下命令检验是否配置成功：
$ pkg-config --libs opencv4
注：若有多个版本，可在CMakeList.txt中指定版本，如指定3.2.0：
find_package(OpenCV 3.2.0 REQUIRED)
运行示例
在刚刚的目录下：（源码目录samples/cpp/example_cmake，请先cmake ./再make编译）
$ ./opencv_example
若有摄像头则会打开摄像，若无则会弹出界面显示“HELLO OPENCV”
至此，若程序成功跑起来，证明opencv安装成功！
4. OPENCV_CONTRIB的编译安装
4.1 下载opencv_contrib
同上，官网下载对应版本：opencv_contrib-4.2.0.zip
Github官方：GitHub - opencv/opencv_contrib: Repository for OpenCV's extra modules
解压移动
解压contrib，并移动到opencv目录下：
$ unzip opencv_contrib-4.2.0.zip
$ mv opencv_contrib-4.2.0 opencv-4.2.0
4.2 配置编译项
先将之前编译opencv的build目录清空，再配置：
$ cd opencv-4.2.0 /build
$ rm * -rf
$ cmake -D CMAKE_BUILD_TYPE=Release -D OPENCV_GENERATE_PKGCONFIG=YES -D CMAKE_INSTALL_PREFIX=/usr/local/opencv4 -D OPENCV_EXTRA_MODULES_PATH=../opencv_contrib-4.2.0/modules/ ../
对比编译opencv时多了OPENCV_EXTRA_MODULES_PATH参数，指定contrib库modules的路径。
4.3 编译
$make
4.4 错误处理
错误1：
[84%]:opencv-4.2.0/opencv_contrib-4.2.0/modules/xfeatures2d/src/boostdesc.cpp:654:37: fatal error: boostdesc_bgm.i: 没有那个文件或目录原因1：在配置时会自动下载此文件，但失败了：
-- xfeatures2d/boostdesc: Download: boostdesc_bgm.i-- Try 1 failed …解决1：缺少文件，手动将文件放于上述路径中（见附件：boostdesc_xxx.i与vgg_xxx.i文件.rar），将所有文件放于opencv_contrib-4.2.0/modules/xfeatures2d/src/下。
错误2：
[85%]: opencv-4.2.0/opencv_contrib-4.2.0/modules/xfeatures2d/test/test_rotation_and_scale_invariance.cpp:7:82: fatal error: features2d/test/test_detectors_invariance.impl.hpp: 没有那个文件或目录解决2：能在opencv-4.2.0/modules/features2d/test/找到些文件，将其复制到opencv_contrib-4.2.0/modules/xfeatures2d/test/目录下，并将出错的地方修改：
test_rotation_and_scale_invariance.cpp文件中第7行：
将#include "features2d/test/test_detectors_regression.impl.hpp" 改为：
#include "test_detectors_regression.impl.hpp"
根据错误提示修改，其他的类似错误也是这样改，直到编译通过。（共5处）
[100%] Linking CXX executable ../../bin/opencv_version
[100%] Built target opencv_version最终编译成功！
温馨提示：缺少的文件可在官方github上opencv_3rdparty选择相应branch下载:
GitHub - opencv/opencv_3rdparty at contrib_xfeatures2d_boostdesc
错误3：
c++: internal compiler error: Killed (program cc1plus)
原因3：内存不足导致的
解决3：将虚拟机内存扩大（如：由2G扩至3G），之后再编译即可通过。
错误4：
可能还会出现跟JAVA相关的错误，可以将JAVA关掉：
在CMAKE时将JAVA关掉，加上：
-D BUILD_BUILD=NO
4.5 安装
$ sudo make install
到此，安装完成！