一. 背景

目前维护的某个项目是在 Windows 下运行的，并且使用了 OpenCV 4.5.2 版本。

我本地的开发环境是 Mac 并使用了比较新的 OpenCV 4.8.1 版本。为了和本地开发环境保持一致，我打算对项目中使用的 OpenCV 进行升级，因为该项目还是用了扩展模块的一些功能，所以需要自行编译。

本文只是记录自己在编译时踩过的坑，避免下次再犯或者给有需要的人。

二. 需要准备的软件

CMake 3.13 或者以上版本
https://cmake.org/

cmake.png

Visual Studio 2022 社区版本
https://visualstudio.microsoft.com/zh-hans/vs/

OpenCV 4.8.1 源码包
https://github.com/opencv/opencv/releases/tag/4.8.1

opencv.png

OpenCV 4.8.1 扩展模块源码包
https://github.com/opencv/opencv_contrib/releases/tag/4.8.1

扩展模块.png

三. 编译

3.1 使用 CMake

3.1.1 准备工作

解压 OpenCV4.8.1 源码包和扩展模块源码包到某个位置

源码包和扩展模块源码包.jpg

打开 cmake-gui，设置 OpenCV4.8.1 源码的位置和输出编译的二进制文件的位置

源码的位置.jpg

3.1.2 Configure

点击"Configure"，弹窗会显示build目录没有创建，是否需要创建。

点击"Configure".jpg

点击“Yes"之后，CMake 会让你选择使用什么工具来生成这个项目。我们采用 Visual Studio 2022。

选择工具.jpg

"Configure"配置成功后，会出现这个界面

配置成功后.jpg

此时，我们可以设置扩展模块的路径

设置扩展模块的路径.jpg

扩展模块的路径在设置时，一定要到 modules 这个文件夹，否则后面再次"Configure"会失败。

如果需要编译 OpenCV World 模块，也需要在这里单独设置。

设置world模块.jpg

World 模块是一个超级模块(super-module)，它结合了用户选择的所有其它模块。它是一个一体化(all-in-one)模块,具有所有库的功能。

然后再次点击"Configure"。

再次点击"Configure".jpg

此时，最好看一下 CMake 的下载日志，下面的文件是 CMake 的下载日志。

cmake 的下载日志.jpg

某些文件的无法下载可能会最终导致 OpenCV World 模块无法编译成功。

我主要是修改这几个地方：

a. 进入 C:/opencv-4.8.1/opencv-4.8.1/3rdparty/ippicv 目录
将 ippicv.cmake 的 https://raw.githubusercontent.com 修改为：https://raw.staticdn.net
b. 进入 C:/opencv-4.8.1/opencv-4.8.1/3rdparty/fmpeg 目录
将 ffmpeg.cmake 的 https://raw.githubusercontent.com 修改为：https://raw.staticdn.net
c. 进入 C:/opencv_contrib-4.8.1/opencv_contrib-4.8.1/modules/xfeatures2d/cmake 目录
将 download_boostdesc.cmake 中的https://raw.githubusercontent.com 修改为：https://raw.staticdn.net
d. 进入 C:/opencv_contrib-4.8.1/opencv_contrib-4.8.1/modules/xfeatures2d/cmake 目录
将 download_vgg.cmake 中的 https://raw.githubusercontent.com 修改为：https://raw.staticdn.net
e. 进入 C:/opencv_contrib-4.8.1/opencv_contrib-4.8.1/modules/face 目录
修改 CMakeLists.txt, 将https://raw.githubusercontent.com 修改为：https://raw.staticdn.net