OpenCV4.4.0 安装测试 Installation & Examination (Ubuntu18.04, Ubuntu 20.04)

时间:2021-05-14 12:34:54

OpenCV4.4.0 安装测试 Installation & Examination (Ubuntu18.04, Ubuntu 20.04)

单纯简单的 OpenCV 安装配置方法,在这个地方已经踩过好几次坑了,这次是基于 WSL 平台,Ubuntu 20.04 进行的安装,但是其中遇到的问题基本上已经足够用于 Linux 系统的各种意外了

下载 dependencies

安装 OpenCV4.4 需要一些准备工作(不包含 python),首先要做的是下载它的一些 dependency(来自 Ubuntu 20.04 从源码编译并配置OpenCV 4.4.0 以及 python 3.8 支持):

# If you don't have cmake:
# sudo apt-get install cmake
sudo apt-get install libswscale-dev libtiff5-dev libgtk2.0-dev pkg-config
sudo apt install build-essential
sudo apt install cmake git libgtk2.0-dev pkg-config libavcodec-dev libavformat-dev libswscale-dev
sudo apt install libtbb2 libtbb-dev libjpeg-dev libpng-dev libtiff-dev libjasper-dev libdc1394-22-dev
# If need to support python3:
# sudo apt install python3-dev python3-numpy
# If need ffmpeg:
sudo apt install ffmpeg

如果安装成功了就不用看下面这些了,但是我遇到了各种问题:

意外Ⅰ.依赖损坏导致的 apt-get 中 Unmet dependencies 问题

可能系统由于之前某(几)次 apt-get upgrade 过程中断,导致依赖损坏;安装新的包时,提示Unmet dependencies,解决方案来源于如何解决 apt-get 中 Unmet dependencies 问题,这个时候可以尝试去根据提示信息,运行 apt-get -f install 来修复问题就解决了。

简单来说,就是先执行上述修复命令,然后更新升级一下确保没留什么隐患:

sudo apt --fix-broken install
sudo apt-get update
sudo apt-get upgrade

如果网络不好,你可以运行多次这些命令,下到一半的包(据我所知)是可以接着前面继续下载的... ...

意外Ⅱ.Ubuntu18.04+上找不到 libpng12.0 的问题

在上面安装包的时候发生报错类似于 Package libpng12-0 is not installed,而且无论如何挣扎,网有多好都装不上这个东西,解决方案来自修复了在 Ubuntu 18.04、19.10、20.04 上找不到的 libpng12-0,据说这已经不是个新的问题了,只是用户升级到更高版本如18.04,19.10,20.04后,“libpng12 不再在Ubuntu存储库档案中可用,从而导致新的 libpng(libpng16)库安装失败。”

这里是 Ubuntu20.04、19.10 或 19.04 上的问题的解决方案,可以使用使用更新的libpng12-0软件包创建的 PPA 安装 libpng。添加 PPA 并使用以下命令安装 libpng12-0(手动安装、18.04/Linux Mint 19 的解决方案以及其它问题见前面的链接):

sudo add-apt-repository ppa:linuxuprising/libpng12
sudo apt update
sudo apt install libpng12-0

成功后,PPA 版本中不再发生上述错误。

意外Ⅲ.Ubuntu20.04+ 系统遇到的 Can not locate package "libjasper-dev"

如果报错 Can not locate package "libjasper-dev",八成是网络差造成的,解决方案为添加一下下面这个源:

sudo add-apt-repository "deb http://security.ubuntu.com/ubuntu xenial-security main"

然后重新 install 一下 libjasper-dev 相关的库大概就可以了。

安装&编译

生成 Makefile

注意上面的都务必先安装成功,然后输入如下命令构建 Makefile:

cd opencv-4.4.0
mkdir build
cd build
cmake \
-D CMAKE_BUILD_TYPE=Release -D CMAKE_INSTALL_PREFIX=/usr/local \
-D OPENCV_GENERATE_PKGCONFIG=ON -D OPENCV_ENABLE_NONFREE=ON \
-D OPENCV_EXTRA_MODULES_PATH=/home/optic_css/opencv-4.4.0/opencv_contrib-4.4.0/modules/ \
-D BUILD_opencv_world=YES \
-D BUILD_opencv_python2=OFF -D BUILD_opencv_python3=OFF \
-D WITH_OPENGL=ON -D WITH_EIGEN=ON \
-D BUILD_EXAMPLES=ON -D BUILD_DOCS=ON \
..

上面的cmake命令中有几点需要注明的:

  • CMAKE_BUILD_TYPE一定要设置成Release的;
  • CMAKE_INSTALL_PREFIX要写成你自己想要安装的路径,不写的话默认是/usr/localinclude/, bin/, lib/3个文件夹下;
  • 由于4.0以后的版本不再有默认设置的opencv4.pc文件,在这里要记得手动设置下OPENCV_GENERATE_PKGCONFIG是开着的来支持pkg-config功能;
  • OPENCV_ENABLE_NONFREE开启后会允许使用已申请专利的算法们,还是值得打开一下的;
  • OPENCV_EXTRA_MODULES_PATH填写contrib库的位置,我的contrib源文件放在了opencv-4.4.0的文件夹下,按理说可以放在任何位置,最好弄得和我一样叭;
  • BUILD_opencv_world作为综合所有头文件的东西,还是打上勾;
  • 这里把关于python方面的编译都给关掉了;
  • 为了使用相关的exampledoc,把这两个对应的开关打开;

意外Ⅳ. Makefile生成时卡在了ippicv的下载上

cmake .. 命令运行时,卡在了(基本是因为网太差,或者是网址被 ban 了):

IPPICV: Download: ippicv_2020_lnx_intel64_20191018_general.tgz

解决方案参考了OpenCV 中手动安装 ippicv(ubuntu),具体来说,采取的是先找到下载这个东西的网址,然后进入网址手动下载后放在XXX路径,去文件里面手动改一下下载路径到本地路径即可。

下载 ippcv 文件的网址被放在了 opencv-x.x.x\3rdparty\ippicv\ippicv.cmake 文件中,打开文件,找到下面这三部分语句:

  # Commit SHA in the opencv_3rdparty repo
set(IPPICV_COMMIT "a56b6ac6f030c312b2dce17430eef13aed9af274")
################################################################################################
"${OPENCV_IPPICV_URL}"
"$ENV{OPENCV_IPPICV_URL}"
"https://raw.githubusercontent.com/opencv/opencv_3rdparty/${IPPICV_COMMIT}/ippicv/"
################################################################################################
if(X86_64)
set(OPENCV_ICV_NAME "ippicv_2020_lnx_intel64_20191018_general.tgz")
set(OPENCV_ICV_HASH "7421de0095c7a39162ae13a6098782f9")

提取一下红色字符串里面的信息,得到目标文件的下载网址为 https://raw.githubusercontent.com/opencv/opencv_3rdparty/a56b6ac6f030c312b2dce17430eef13aed9af274/ippicv/ippicv_2020_lnx_intel64_20191018_general.tgz,下载得到 ippicv_2020_lnx_intel64_20191018_general.tgz,把文件放在一个你喜欢的位置,我放在了 file:/home/optic_css/opencv-4.4.0(如果不能下载,移步 ubuntu 安装 opencv 无法下载 IPPICV 的问题ippicv_2020_lnx_intel64_20191018_general.tgz)。这样之后再把以前的文件中的网址改成本地地址就好了,也就是说,把 ippicv.cmake 文件中的:

  "${OPENCV_IPPICV_URL}"
"$ENV{OPENCV_IPPICV_URL}"
"https://raw.githubusercontent.com/opencv/opencv_3rdparty/${IPPICV_COMMIT}/ippicv/"

改成你的本地下载地址:

  "${OPENCV_IPPICV_URL}"
"$ENV{OPENCV_IPPICV_URL}"
"file:/home/optic_css/opencv-4.4.0"
#"https://raw.githubusercontent.com/opencv/opencv_3rdparty/${IPPICV_COMMIT}/ippicv/"

意外Ⅴ. Makefile生成后发现有未能下载的文件

发现有下面这些文件在 cmake 的时候没有下载下来(你可以在 build/CMakeDownloadLog.txt 中查看,查找 #cmake_download,在其后首先列出的是文件名,接着是下载地址):

于是手动一个一个地把它们下载下来,放在路径 /opencv-4.4.0/opencv_contrib-4.4.0/modules/xfeatures2d/src/ 下就可以了,不用再次生成 Makefile。

编译(未在编译中遇到除了时间长以外的任何问题)

有在编译中遇到问题的可以看 Ubuntu18.04+Opencv4.4.0+contrib 详细配置过程或者自己去网上查

生成好 Makefile 之后就可以直接编译、下载了(先看一下电脑有几个核,考虑多线程编译叭,不然直接慢die):

make -j8
sudo make install

开了八个线程之后的结果就是等了将近一个小时,编译成功输出的东西是下面这一坨:[OpenCV4.4.0 Compiling Output](2020. Oct. OpenCV4.4.0_Compiling_Output_optics_css@qq.com.txt),虽然基本看不懂里面那些库都是啥,但是仍然很有成就感?

OpenCV4.4.0的环境配置

添加/usr/local/lib作为程序执行时共享库*.so的路径

/etc/ld.so.conf.d/opencv4.conf 中(如果没有就自己新建一个)写入 /usr/local/lib,用 nano 打开这个文件并修改:

sudo nano /etc/ld.so.conf.d/opencv4.conf

没有的话就直接新建,然后写入这个内容:

# libc default configuration
/usr/local/lib

保存(似乎是 Ctrl+X,然后 Y 确认写入 Buffer,然后 Enter 确认要把文件命名为默认),然后更新一下配置:

sudo ldconfig

配置pkg-config环境到bash.bashrc

向上面一样,nano 打开 /etc/bash.bashrc

sudo nano /etc/bash.bashrc

然后在文件内容的末尾加上这些:

# Add in the end
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig
export PKG_CONFIG_PATH

保存,然后激活一下:

source /etc/bash.bashrc
sudo updatedb

写/usr/local/lib到ld.so.conf

有时会报错 error while loading shared libraries: libopencv_core.so.*,因此无论如何也应该加一句 /usr/local/lib/etc/ld.so.conf,不赘述,直接进入然后加上这一句就好了:

sudo nano /etc/ld.so.conf

保存,然后更新一下:

sudo ldconfig

检测OpenCV4.4.0安装成功

这样就算是安装完成了,就算你运行:

pkg-config --modversion opencv

然后告诉你找不到这个包也无所谓,因为我们安装的是新版本,要运行与检测的是:

pkg-config --modversion opencv4

输出,如果不行的话就有必要去看看 Package opencv was not found in the pkg-config search path

root@LAPTOP-3SQ4QCQT:/home/optic_css# pkg-config --modversion opencv4
>> 4.4.0

就算是成功了,进一步还可以运行如下指令,试一下代码是否能跑出来:

cd /mnt/c/Users/a1020/Desktop/Reinforcement_ELyou/Demolist/slamdemo/slambook/ch6
mkdir build
cd build
cmake ..
make -j8