Windows 下使用 CMake + Visual Studio 2022 编译 OpenCV 4.8.1 及其扩展模块
Windows 下使用 CMake + Visual Studio 2022 编译 OpenCV 4.8.1 及其扩展模块
一. 背景
目前维护的某个项目是在 Windows 下运行的，并且使用了 OpenCV 4.5.2 版本。
我本地的开发环境是 Mac 并使用了比较新的 OpenCV 4.8.1 版本。为了和本地开发环境保持一致，我打算对项目中使用的 OpenCV 进行升级，因为该项目还是用了扩展模块的一些功能，所以需要自行编译。
本文只是记录自己在编译时踩过的坑，避免下次再犯或者给有需要的人。
二. 需要准备的软件
CMake 3.13 或者以上版本 https://cmake.org/
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 4.8.1 扩展模块源码包 https://github.com/opencv/opencv_contrib/releases/tag/4.8.1
三. 编译
3.1 使用 CMake
3.1.1 准备工作
解压 OpenCV4.8.1 源码包和扩展模块源码包到某个位置
打开 cmake-gui，设置 OpenCV4.8.1 源码的位置和输出编译的二进制文件的位置
3.1.2 Configure
点击"Configure"，弹窗会显示build目录没有创建，是否需要创建。
点击“Yes"之后，CMake 会让你选择使用什么工具来生成这个项目。我们采用 Visual Studio 2022。
"Configure"配置成功后，会出现这个界面
此时，我们可以设置扩展模块的路径
扩展模块的路径在设置时，一定要到 modules 这个文件夹，否则后面再次"Configure"会失败。
如果需要编译 OpenCV World 模块，也需要在这里单独设置。
World 模块是一个超级模块(super-module)，它结合了用户选择的所有其它模块。它是一个一体化(all-in-one)模块,具有所有库的功能。
然后再次点击"Configure"。
此时，最好看一下 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
之后再重新"Configure"即可。
3.1.3 Generate
接下来，点击"Generate"生成使用 CMake 构建的项目
3.1.4 Open Project
最后点击"Open Project"，唤起 Visual Studio 2022 打开该项目。
当然也可以去输出编译的二进制文件的目录(C:/opencv-4.8.1/newbuild) ，打开 OpenCV.sln 文件达到同样的效果。
点击"Open Project".jpg
3.2 使用 Visual Studio 2022
在编译之前，先配置 opencv_world 模块，然后选择 release 或者 debug。
找到 CMakeTargets，选择 ALL_BUILD 进行生成。
上述步骤生成成功后，选择 INSTALL 进行生成。
INSTALL 生成成功后，这次编译算是大功告成了。我们完成了OpenCV4.8.1 及其扩展模块的编译。
我们可以在输出编译的二进制文件的目录(C:/opencv-4.8.1/newbuild)下找到 install 文件夹
install 文件夹最终输出的内容如下
我们也成功编译了 opencv_world 模块。
四. 总结
本文只是便于自己日后翻阅和查找。
不过整个编译过程花费了1天多才搞定。编译的时候遇到各种问题，其实只要仔细阅读日志进行分析，总能解决。
当然，自行编译 OpenCV 库有很多好处，可以根据自己的需要定制 OpenCV 库，可以针对特定的硬件平台优化 OpenCV 库等等。