【OpenCV 】Ubuntu系统下配置安装OpenCV开发环境
开发环境
- 物理主机：Win 10 64位
- 虚拟工具：VMware Workstation 15 Pro
- 虚拟系统：Ubuntu 20.04.4 LTS
- 软件版本： OpenCV 4.6.0
一、前提准备
首先，需要安装一系列必要的工具，包括：
$ sudo apt-get update # 这是为了更新你的软件源
$ sudo apt-get install build-essential # 这是为了安装编译所需的库
$ sudo apt-get install cmake pkg-config git # 这是为了安装一些必要的工具
$ sudo apt-get install libgtk2.0-dev libavcodec-dev libavformat-dev libswscale-dev python-dev python-numpy libtbb2 libtbb-dev libjpeg-dev libpng-dev libtiff-dev libtiff4.dev libswscale-dev libjasper-dev libdc1394-22-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev
然后，可以去网上下载OpenCV的源码，我是采取git仓库克隆的方式，直接获取最新的版本，如下：
$ git clone https://github.com/opencv/opencv
二、编译安装
1、建立编译目录
源码下载完成后，进入该目录下，执行以下语句：
$ cd opencv
$ mkdir build
$ cd build
这是为了在源码的根目录下建立一个临时目录，用于存放编译所产生的文件，不至于污染源码，使得你的源码可以根据不同的配置命令分别编译出多份可执行文件，每一份都很清晰，不至于混在一起。
这个思路，有一个很官方的名字叫OUT SOURCE BUILD，意思就是在代码之外的地方进行编译。而与其相对的，就是IN-SOURCE BUILD，意味在代码内进行编译。
所以，如果没有按照上面的步骤新建一个目录然后到目录里面去编译的话，系统就会给出一个提示说：In-source builds are not allowed.。
2、编译安装源码
$ cmake -D CMAKE_BUILD_TYPE=Release -D CMAKE_INSTALL_PREFIX=/usr/local ..
$ make
$ sudo make install
注意：在第一步中，配置了两个参数，第一个参数是指定程序为发布版本，第二个参数是指定安装目录，也可以根据自己的需要自定义修改（不过强烈建议大家不要改，就按这个/usr/local目录，不然后面可能会遇到一些麻烦）。
三、配置环境
1、添加库路径
打开文件进行编辑：
$ sudo vi /etc/ld.so.conf.d/opencv.conf
输入下面的内容，然后保存并退出
/usr/local/lib
2、添加环境变量
打开文件进行编辑：
$ sudo vi /etc/profile
在末尾加入：
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib
3、更新环境变量
$ sudo source /etc/profile
4、重启，然后输入命令
$ pkg-config --modversion opencv # 查看linux下的opencv安装版本
4.6.0
如果没有出错，说明安装成功。
注意：如果报了如下错误 Package opencv was not found in the pkg-config search path：
Package opencv was not found in the pkg-config search path.
Perhaps you should add the directory containing `opencv.pc'
to the PKG_CONFIG_PATH environment variable
No package 'opencv' found
那就是缺失了opencv.pc这个配置信息文件，故解决方法就是添加这个文件然后将其导入到环境变量中，具体操作如下：
1、首先创建opencv.pc文件（需要注意它的路径信息）
$ cd /usr/local/lib
$ sudo mkdir pkgconfig
$ cd pkgconfig
$ sudo touch opencv.pc
2、然后在opencv.pc中添加以下信息（注意这些信息需要与自己安装opencv时的库路径对应）
prefix=/usr/local
exec_prefix=${prefix}
includedir=${prefix}/include
libdir=${exec_prefix}/lib
Name: opencv
Description: The opencv library
Version:4.6.0
Cflags: -I${includedir}/opencv4
Libs: -L${libdir} -lopencv_shape -lopencv_stitching -lopencv_objdetect -lopencv_superres -lopencv_videostab -lopencv_calib3d -lopencv_features2d -lopencv_highgui -lopencv_videoio -lopencv_imgcodecs -lopencv_video -lopencv_photo -lopencv_ml -lopencv_imgproc -lopencv_flann -lopencv_core
~
3、保存退出，然后将文件导入到环境变量
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
至此就配置好opencv.pc，再执行 pkg-config --modversion opencv命令试试。
四、测试效果
完成了上述的所有步骤，就已经差不多了，接下来就开始进行验证测试。
进入opencv的源码目录，里面有一个sample/cpp/example_cmake的子目录，里面有一个很简单的例程，我们就用这个例程来进行演示：
$ cd opencv/samples/cpp/example_cmake/
$ cmake . # 请注意，这里的cmake后有一个空格，然后是一个点号
$ make
编译成功了，运行一下试试：
$ ./opencv_example
Built with OpenCV 4.6.0-dev
(opencv_example:13315): GStreamer-CRITICAL **: gst_element_get_state: assertion 'GST_IS_ELEMENT (element)' failed
VIDEOIO ERROR: V4L: can't open camera by index 0
No capture
这是因为用的是虚拟机，没有摄像头，因此显示了黑屏。如果使用的是物理机，也有摄像头，那么就会显示出摄像头的画面并叠加上hello opencv的提示语句。
到此，所有工作全部顺利完成！恭喜！
五、问题解决
如果刚才配置编译和安装目录的时候，没有设置为缺省的/usr/local目录， 而是设置了其他的目录（比如/usr/local/opencv-4.6.0这个目录），则有可能会在后面在应用的过程中遇到一个问题，就是使用cmake命令编译某个工程项目时，提示说：
CMake Error at CMakeLists.txt:39 (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.
原因就是因为安装opencv时没有使用的默认的路径，导致cmake找不到opencv。
解决方法也很简单，执行cmake命令前，先输入下面的语句：
$ export OpenCV_DIR=/usr/local/opencv-4.6.0 # 这里的/usr/local/opencv-4.0.0目录就是你安装的实际目录
然后再执行cmake命令，按照之前的步骤一步步往下。