下一个教程 : 在使用 gdb 的集成开发环境中使用 OpenCV

原作者

Ana Huamán

兼容性

OpenCV >= 3.0

快速开始

构建核心模块

# 安装最低限度的先决条件(以 Ubuntu 18.04 为参考)
sudo apt update && sudo apt install -y cmake g++ wget unzip
# 下载并解压源代码
wget -O opencv.zip https://github.com/opencv/opencv/archive/4.x.zip
unzip opencv.zip
# 创建构建目录
mkdir -p build && cd build
# 配置
cmake ../opencv-4.x
# 生成
cmake --build .

使用 opencv_contrib 构建

# 安装最低限度的先决条件(以 Ubuntu 18.04 为参考)
sudo apt update && sudo apt install -y cmake g++ wget unzip
# 下载并解压源代码
wget -O opencv.zip https://github.com/opencv/opencv/archive/4.x.zip
wget -O opencv_contrib.zip https://github.com/opencv/opencv_contrib/archive/4.x.zip
unzip opencv.zip
unzip opencv_contrib.zip
# 创建 build 目录并切换到该目录
mkdir -p build && cd build
# 配置
cmake -DOPENCV_EXTRA_MODULES_PATH=../opencv_contrib-4.x/modules ../opencv-4.x
# 生成
cmake --build .

详细流程

本节提供了构建过程的更多细节,并介绍了替代方法和工具。请参阅 OpenCV 安装概述 教程了解一般安装细节,并参阅 OpenCV 配置选项

安装编译器和构建工具

  • 要编译 OpenCV,您需要一个 C++ 编译器。通常是 G++/GCC 或 Clang/LLVM:
  • 安装 GCC…
sudo apt install -y g++
  • 或 Clang
sudo apt install -y clang
  • OpenCV 使用 CMake 构建配置工具:
sudo apt install -y cmake
  • CMake 可以为不同的构建系统生成脚本,例如 make、ninja:
  • 安装 Make…
sudo apt install -y make
  • … 或Ninja
sudo apt install -y ninja-build
  • 获取和解压源代码的安装工具:
  • wget 和 unzip…
sudo apt install -y wget unzip
  • … 或 git
sudo apt install -y git

下载源代码

获取 OpenCV 源代码有两种方法:

  • 使用网络浏览器或任何下载工具下载软件源快照(约 80-90Mb ),然后解压缩…
wget -O opencv.zip https://github.com/opencv/opencv/archive/4.x.zip
unzip opencv.zip
mv opencv-4.x opencv
  • …或使用 git 将版本库克隆到本地计算机,以获取完整的更改历史(>470Mb):
git clone https://github.com/opencv/opencv.git
git -C opencv checkout 4.x

注释 其他分支、版本或提交的快照可在 GitHub 和官方下载页面上找到。

配置和构建

  • 创建构建目录
mkdir -p build && cd build
  • 配置 - 为首选的构建系统生成构建脚本:
  • 对于 make…
cmake ../opencv
  • … 或对于Ninja
cmake -GNinja ../opencv
  • 编译 - 运行实际编译过程:
  • 使用 make…
make -j4
  • … 或Ninja
ninja

注意事项 配置过程会从互联网下载一些文件以满足库的依赖性,连接失败可能会导致某些模块或功能关闭或表现不同。有关详细信息和完整的配置选项参考,请参阅 **OpenCV 安装概述**和 OpenCV 配置选项参考教程。 如果在构建过程中遇到问题,请尝试清理或重新创建构建目录。更改配置(如禁用依赖关系、修改编译脚本或将源代码切换到另一个分支)不会得到很好的处理,可能会导致工作区损坏。 Make 可以并行运行多个编译进程,-j<NUM> 选项表示 “同时运行 <NUM> 作业”。Ninja 会自动检测可用处理器内核的数量,不需要 -j 选项。

检查编译结果

编译成功后,你会在 build/lib 目录下找到库,并在 build/bin 目录下找到可执行文件(测试、示例、应用程序):

ls bin
ls lib

CMake 软件包文件将位于构建根目录下:

ls OpenCVConfig*.cmake
ls OpenCVModules.cmake

安装

警告 安装过程只会将文件复制到预定义的位置,并进行少量修补。使用此方法安装不会将 opencv 集成到系统软件包注册表中,因此无法自动卸载 opencv。由于可能与系统软件包发生冲突,我们不建议普通用户在全系统范围内安装。

默认情况下,OpenCV 将被安装到 /usr/local 目录,所有文件将被复制到以下位置:

/usr/local/bin - 可执行文件/usr/local/lib - 库 (.so)/usr/local/cmake/opencv4 - cmake 软件包/usr/local/include/opencv4 - 头文件/usr/local/share/opencv4 - 其他文件(例如,XML 格式的训练级联) 由于 /usr/local 为根用户所有,因此安装时应提升权限 (sudo):

sudo make install

sudo ninja install

可使用 CMAKE_INSTALL_PREFIX 配置参数更改安装根目录,例如 -DCMAKE_INSTALL_PREFIX=$HOME/.local 安装到当前用户的本地目录。可以使用 OPENCV_*_INSTALL_PATH 参数更改安装布局。详情请参见 OpenCV 配置选项参考。