1. 安装依赖

注解: 带有 (*) 的表示必须安装

1.1 OpenCV (*)

OpenCV [7] 是 RMVL 必需的依赖库，如果没有找到 OpenCV 库，RMVL 将无法构建，下面介绍 OpenCV 的 2 种安装方法。

快速安装

Linux 发行版常用的镜像站中一般都添加了 OpenCV 的软件源，可以很方便的通过 apt 包管理工具安装，例如 Ubuntu

18.04 对应的 OpenCV 版本是 3.2.0

此版本过低，无法通过 CMake 的 find_package 方式找到 OpenCV，若是在这个 Ubuntu 的发行版，请手动编译安装 4.0 或以上版本的 OpenCV
20.04 对应的 OpenCV 版本是 4.2.0
22.04 对应的 OpenCV 版本是 4.5.4

可以输入以下命令行进行安装

sudo apt install libopencv-dev

编译安装

安装 OpenCV 依赖

sudo apt install build-essential

sudo apt install libgtk2.0-dev libavcodec-dev libavformat-dev libjpeg-dev libswscale-dev libtiff5-dev pkg-config

下载并解压缩 OpenCV

wget https://codeload.github.com/opencv/opencv/tar.gz/refs/tags/4.7.0

tar -xvf 4.7.0

构建 OpenCV

cd opencv-4.7.0
mkdir build && cd build
cmake \
  -DBUILD_EXAMPLES=OFF \
  -DBUILD_PERF_TESTS=OFF \
  -DBUILD_TESTS=OFF \
  -DBUILD_opencv_python3=OFF \
  -DBUILD_JAVA=OFF \
  -DBUILD_opencv_js=OFF \
  -DBUILD_opencv_gapi=OFF \
  -DOPENCV_ENABLE_NONFREE=ON \
  -DENABLE_FAST_MATH=ON \
  -DWITH_GSTREAMER=ON \
  -DCMAKE_BUILD_TYPE=Release \
  ..
 
make -j8 && sudo make install

参见

OpenCV documents

1.2 Eigen3 (*)

使用 apt 包管理工具进行安装

sudo apt install libeigen3-dev

1.3 硬件设备 SDK

设备	品牌	CMake 包 `find_package(..)`	SDK 下载地址（点击即可下载）
相机	MindVision	MvSDK	For all arch
	HikVision	HikSDK	For all arch
	OPT	OPTCameraSDK	For all arch
光源控制器	OPT	OPTLightCtrl	For amd64

注解: 以上与相机相关的 SDK 在进行二次封装得到的库都需要链接到 OpenCV。

1.4 onnxruntime

onnxruntime 库是目前数字识别所依赖的第三方库，如果有需要开启此功能，则需要安装 onnxruntime

获取压缩包
curl -SL https://github.com/microsoft/onnxruntime/releases/download/v1.12.0/onnxruntime-linux-x64-1.12.0.tgz -o onnxruntime-linux-x64-1.12.0.tgz
解压
tar -xvf onnxruntime-linux-x64-1.12.0.tgz
安装（复制头文件与库文件）
sudo mkdir /usr/local/include/onnxruntime

sudo cp onnxruntime-linux-x64-1.12.0/include/* /usr/local/include/onnxruntime

sudo cp -r onnxruntime-linux-x64-1.12.0/lib /usr/local
移除中间文件
rm -r onnxruntime-linux-x64-1.12.0 && rm onnxruntime-linux-x64-1.12.0.tgz

2. 配置 RMVL 项目

进入编译空间，没有 build 文件夹请先创建

cd build

请继续在终端中输入以下内容

cmake ..

或者使用图形用户界面（GUI）来配置 RMVL

cmake-gui ..

注解: 若需要启用单元测试，请输入
cmake -D BUILD_TESTS=ON ..

3. 构建 RMVL 并进行单元测试

3.1 编译安装

编译 RMVL（这里开启 8 个线程进行编译，可灵活设置）

make -j8

注解: 若启用了单元测试，可以运行 RMVL 单元测试的测试用例
ctest

在构建完成之后，可以通过 make install 来安装 RMVL 的头文件、库文件、和 CMake 配置文件

sudo make install

同样可以选择线程数来加速安装过程

sudo make install -j4

3.2 检查安装结果

在任意一个地方打开终端，输入

rmvl_version

如果显示了对应的版本号，则安装成功。同时，也可查看构建时的配置情况

rmvl_version -v

若想为 RMVL 编写测试 demo，请继续阅读下一篇：通过 gcc 和 CMake 使用 RMVL 。

目录