OpenCV安装概述

目录

• 预编译版本
  • OpenCV核心团队提供的软件包
  • 第三方软件包
• 从源码编译
  • 步骤0：准备工作
  • 步骤1：获取软件源代码
  • 步骤2：配置
  • 步骤3：构建
  • (可选) 步骤3：安装
  • (可选) 步骤4：构建插件

下一教程： OpenCV 配置选项参考

在你的机器上安装OpenCV有两种方法：下载适合你平台的预编译版本或从源码编译。

预编译版本

在许多情况下，你可以找到满足你需求的OpenCV预编译版本。

OpenCV核心团队提供的软件包

针对Android、iOS和Windows的软件包使用默认参数和最新的编译器构建，每个版本都会发布，它们不包含opencv_contrib模块。

• GitHub releases: https://github.com/opencv/opencv/releases
• SourceForge.net: https://sourceforge.net/projects/opencvlibrary/files/

第三方软件包

其他组织和个人维护他们自己的OpenCV二进制发行版。例如：

• 流行Linux发行版中的系统软件包 (https://pkgs.org/search/?q=opencv)
• PyPI (https://pypi.ac.cn/search/?q=opencv)
• Conda (https://anaconda.org/search?q=opencv)
• Conan (https://github.com/conan-community/conan-opencv)
• vcpkg (https://github.com/microsoft/vcpkg/tree/master/ports/opencv)
• NuGet (https://nuget.net.cn/packages?q=opencv)
• Brew (https://formulae.brew.sh.cn/formula/opencv)
• Maven (https://search.maven.org/search?q=opencv)

从源码编译

可能现有二进制包不适用于你的用例，那么你将不得不自己构建自定义版本的OpenCV。本节概述了构建过程，请查看特定平台的教程以获取实际的构建说明。

OpenCV 使用 CMake 构建管理系统进行配置和构建，因此本节主要描述使用 CMake 构建软件的通用过程。

步骤0：准备工作

安装 C++ 编译器和构建工具。在 *NIX 平台上，通常是 GCC/G++ 或 Clang 编译器以及 Make 或 Ninja 构建工具。在 Windows 上，可以使用 Visual Studio IDE 或 MinGW-w64 编译器。Android 的原生工具链在 Android NDK 中提供。XCode IDE 用于为 OSX 和 iOS 平台构建软件。

从官方网站或其他来源安装 CMake。

获取其他第三方依赖项：具有额外功能的库（例如解码视频或显示 GUI 元素）；提供选定算法的优化实现的库；用于文档生成和其他额外功能的工具。查看 OpenCV 配置选项参考 以了解可用选项和相应的依赖项。

步骤1：获取软件源代码

典型的软件项目由一个或多个代码库组成。OpenCV 有两个包含代码的存储库：opencv - 包含稳定且积极支持的算法的主存储库和 opencv_contrib，其中包含实验性和非免费（专利）算法；以及一个包含测试数据的存储库：opencv_extra。

你可以下载作为存档形式的存储库快照，或克隆具有完整历史记录的存储库。

要下载快照存档：

• 访问 https://github.com/opencv/opencv/releases 并从任何版本下载“源代码”存档。
• (可选) 访问 https://github.com/opencv/opencv_contrib/releases 并下载与opencv相同版本的“源代码”存档
• (可选) 访问 https://github.com/opencv/opencv_extra/releases 并下载与opencv相同版本的“源代码”存档
• 将所有存档解压到某个位置

要克隆存储库，请在控制台中运行以下命令（必须安装git git）

git clone https://github.com/opencv/opencv
git -C opencv checkout <some-tag>
 
# 可选
git clone https://github.com/opencv/opencv_contrib
git -C opencv_contrib checkout <same-tag-as-opencv>
 
# 可选
git clone https://github.com/opencv/opencv_extra
git -C opencv_extra checkout <same-tag-as-opencv>

注意

如果你想使用多个存储库构建软件，请确保所有组件都相互兼容。对于 OpenCV，这意味着opencv和opencv_contrib存储库必须签出到相同的标签，或者所有快照存档都必须从相同的版本下载。

在选择下载哪个版本时，请考虑你的目标平台和开发工具版本，最新版本的OpenCV可能与非常旧的编译器存在构建问题，反之亦然。我们建议使用最新版本和最新的操作系统/编译器组合。

步骤2：配置

在此步骤中，CMake 将验证所有必要的工具和依赖项是否可用且与库兼容，并将为所选构建系统生成中间文件。它可能是 Makefiles、IDE 项目和解决方案等。通常，此步骤在新建的构建目录中执行。

cmake -G<generator> <configuration-options> <source-directory>

注意

cmake-gui 应用程序允许使用图形用户界面查看和修改可用选项。详情请参见 https://cmake.com.cn/runningcmake/。

步骤3：构建

在构建过程中，源文件将编译成目标文件，这些目标文件将链接在一起或以其他方式组合成库和应用程序。此步骤可以使用通用命令运行

cmake --build <build-directory> <build-options>

…或者可以直接调用底层构建系统

make

(可选) 步骤3：安装

在安装过程中，构建结果和构建目录中的其他文件将复制到安装位置。默认安装位置在 UNIX 上是/usr/local，在 Windows 上是C:/Program Files。可以通过设置CMAKE_INSTALL_PREFIX选项在配置步骤中更改此位置。要执行安装，请运行以下命令：

cmake --build <build-directory> --target install <other-options>

注意

此步骤是可选的，可以直接从构建目录使用 OpenCV。

如果安装根位置是受保护的系统目录，则必须使用超级用户或管理员权限运行安装过程（例如sudo cmake ...）。

(可选) 步骤4：构建插件

可以通过将部分代码提取到动态加载的插件中，来解耦一些OpenCV的依赖项并使其可选。这有助于生成自适应的二进制发行版，这些发行版可以在依赖项较少的系统上运行，并且只需安装缺少的库即可扩展功能。目前，core、videoio和highgui模块支持这种机制来处理部分依赖项。在某些情况下，可以通过设置VIDEOIO_PLUGIN_LIST或HIGHGUI_PLUGIN_LIST等选项来与OpenCV一起构建插件，更多与这种情况相关的选项可以在OpenCV配置选项参考中找到。在其他情况下，插件应该在其自己的构建过程中单独构建，本节描述了这种独立构建过程。

注意

建议使用与OpenCV构建所使用的编译器、配置和构建选项兼容的选项，否则生成的库可能无法加载或导致其他运行时问题。请注意，由于OpenCV和相应的第三方库之间存在额外的障碍，因此当后端动态加载时，某些功能可能会受到限制或运行速度变慢。

构建过程类似于主要的OpenCV构建，但您必须使用位于相应子目录中的特殊CMake项目，这些文件夹也可能包含参考脚本和Docker镜像。务必为插件使用opencv_<module>_<backend>名称前缀，以便加载器能够找到它们。每个支持的前缀只能用于加载一个库，但是可以探测多个候选项以匹配单个前缀。例如，您可以拥有libopencv_videoio_ffmpeg_3.so和libopencv_videoio_ffmpeg_4.so插件，并且第一个成功加载的插件将占用内部插槽并停止探测过程。下表列出了可能的前缀和项目位置。

模块	后端	位置
core	parallel_tbb, parallel_onetbb, parallel_openmp	opencv/modules/core/misc/plugins
highgui	gtk, gtk2, gtk3	opencv/modules/highgui/misc/plugins
videoio	ffmpeg, gstreamer, intel_mfx, msmf	opencv/modules/videoio/misc

示例

# 设置TBB检测的环境，例如
# export TBB_DIR=<包含tbb-cmake-config的目录>
cmake -G<生成器> \
-DOPENCV_PLUGIN_NAME=opencv_core_tbb_<后缀> \
-DOPENCV_PLUGIN_DESTINATION=<目标文件夹> \
-DCMAKE_BUILD_TYPE=<配置> \
<opencv>/modules/core/misc/plugins/parallel_tbb
cmake --build . --config <配置>

注意

在Windows上，插件必须与现有的OpenCV构建链接。设置OpenCV_DIR环境变量或CMake变量为包含OpenCVConfig.cmake文件的目录，这可以是OpenCV构建目录或您执行安装位置的某个路径。