Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

1 Windows10编译Mediapipe C++版本

Win7我按照底下的步骤试了一下,在bazel编译的时候总是报:

ERROR: SymlinkDirectories(C:/Users/Administrator/_bazel_Administrator/install/7e447298f5ed9555a00a8dcb11768f3e, c:\users\administrator_bazel_administrator\ucdynfbl\install): CreateJunction:
FATAL: failed to create installation symlink 'c:\users\administrator_bazel_administrator\ucdynfbl\install': success

错误截图:

Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

win7上没有成功,但是在win10上成功了。

2 编译步骤

2.1 MSYS2环境配置

MSYS2官网:https://www.msys2.org/

2.1.1 下载安装

点击以下按钮下载msys2

Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

点击安装,自行设置安装位置。

2.1.2 配置系统环境变量

如安装位置为:D:\Program Files (x86)\msys64,则将D:\Program Files (x86)\msys64\usr\bin添加到系统变量中

Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

2022年9月26日更新:

根据网友大佬的反馈,如果使用的系统为Windows11,则还需要明确在系统环境变量中指定BAZEL_SH为:D:\Program Files (x86)\msys64\usr\bin\bash.exe,示例设置图为:

Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

不然在编译时会出现错误,具体可参考:

2.1.3 升级msys2包数据库

打开MSYS2 MSYS
Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

在打开的MSYS命令行中输入:

pacman -Syu
Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

然后就等待各种包下载升级安装。

2.1.4 升级msys2基础数据库

继续在MSYS中输入:

pacman -Su
Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

等待升级完成

2.1.5 下载安装必要的包:unzip

MSYS2没有内置unzip,需要手动安装。

打开cmd.exe,输入以下命令:

pacman -S git patch unzip
Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

等待下载安装完成即可,经过以上步骤,MSYS2的配置就完成了。

2.2 Python环境配置

需要在电脑上安装python,并且配置系统环境,具体步骤就不再赘述。在Python环境中需要装好tensorflow cpu,如果准备编译GPU版本需要安装gpu版本的tensorflow。

如果在电脑上已经使用Anaconda创建虚拟环境,可以使用Anaconda的base环境或者其中的虚拟环境,我是用的就是Anaconda的base环境。

2.3 安装VS2019和WinSDK

VS官网:https://visualstudio.microsoft.com/zh-hans/free-developer-offers/

下载免费的社区版即可,在安装vs2019的过程中会自动安装WinSDK

Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

2.4 配置Bazel

2.4.1 Bazel下载

官方文档的建议是下载Bazel 3.7.2或者更高版本,这里选择Bazel 3.7.2版本下载。

Bazel下载地址:https://github.com/bazelbuild/bazel/releases

在该页面使劲往下翻,翻到3.7.2下载bazel-3.7.2-windows-x86_64.exe

Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

2.4.2 Bazel系统环境配置

下载的文件名为:bazel-3.7.2-windows-x86_64.exe,为了之后可以更好地在cmd.exe中使用,可以拷贝一个副本,并将其改名为bazel.exe,这样在命令行调用的时候只需要输入bazel而不需要输入bazel-3.7.2-windows-x86_64。

如果bazel.exe保存的路径为:F:\软件安装包\bazel,需要将该路径添加到系统环境变量中,使其可以在命令行中调用,需要将其路径添加到系统环境变量

Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

系统环境配置完成之后,在cmd.exe输入bazel,如出现以下提示则说明配置成功。

Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

2.5 设置Bazel变量

根据官方文档,需要设置Bazel的编译变量:

# Please find the exact paths and version numbers from your local version.
C:\> set BAZEL_VS=C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools
C:\> set BAZEL_VC=C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC
C:\> set BAZEL_VC_FULL_VERSION=<Your local VC version>
C:\> set BAZEL_WINSDK_FULL_VERSION=<Your local WinSDK version>

其中:

  • BAZEL_VS : vs2019的安装目录,比如我的:D:\Program Files (x86)\Microsoft Visual Studio\2019\Community
  • BAZEL_VC:vs2019安装目录下C++主要目录,比如我的 BAZEL_VC=D:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC
  • BAZEL_VC_FULL_VERSION : VS2019的中vc的版本号,

该版本号可以在VS2019的安装目录D:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Redist\MSVC下找到:

Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

图片中的14.29.30036就是VC的版本号。

  • BAZEL_WINSDK_FULL_VERSION:WinSDK的版本号,这可以在控制面板-程序-程序和功能中查看,找到Windows Software Development Kit,后面跟的数字就是WinSDK的版本号,如下图所示。
Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

那么最后我的配置项为:

set BAZEL_VS=D:\Program Files \(x86\)\Microsoft Visual Studio\2019\Community
set BAZEL_VC=D:\Program Files \(x86\)\Microsoft Visual Studio\2019\Community\VC
set BAZEL_VC_FULL_VERSION=14.29.30036
set BAZEL_WINSDK_FULL_VERSION=10.0.19041.685

需要在MSYS上设置Bazel变量而不是在cmd.exe中,在MSYS中依次输入上述命令,这里有个坑,Program Files (x86)的这个括号需要进行转义,所以应该变成Program Files (x86)

Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

2.6 下载opencv

官方文档指出目前使用OpenCV 3.4.10,所以下载OpenCV 3.4.10即可。

下载地址:https://opencv.org/releases/

Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

下载完成之后,点击exe,解压到自己想要的目录,这里我的解压目录是:F:\opencv-3.4.10-vc14_vc15,不要使用中文路径,不然在后面编译会出错。

2.7 Mediapipe仓库克隆以及bazel的编译文件WORKSPACE的修改

使用git迁移Mediapipe官方仓库:

git clone https://github.com/google/mediapipe.git

迁移完成之后,打开该仓库根目录下的WORKSPACE文件,并在该文件中搜索“windows_opencv”,并将OpenCV的路径修改为你本地保存OpenCV的路径

修改后:

new_local_repository(
    name = "windows_opencv",
    build_file = "@//third_party:opencv_windows.BUILD",
    path = "F:\\opencv-3.4.10-vc14_vc15\\opencv\\build",
)

保存即可。

2.8 编译并运行hello world

官方文档提示,如果需要在Windows上编译Mediapipe需要添加

--action_env PYTHON_BIN_PATH="C://path//to//python.exe"

在编译命令行中,这里的PYTHON_BIN_PATH就是上述步骤中所安装的python路径,配置好即可。

2.8.1 编译

使用cmd.exe将目录切换到Mediapipe仓库的根目录下,然后运行以下命令:

bazel build -c opt --define MEDIAPIPE_DISABLE_GPU=1 --action_env PYTHON_BIN_PATH="D:\\Anaconda\\python.exe" mediapipe/examples/desktop/hello_world

上述的PYTHON_BIN_PATH需要修改为你自己的python路径,编译过程中需要从github上拉取一些库,所以最好科学上网,不然会出现can't fetch错误。

编译完成可以看到以下信息:

Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

2.8.2 运行

编译完成之后,继续在cmd.exe中依次输入以下命令:

set GLOG_logtostderr=1
bazel-bin\mediapipe\examples\desktop\hello_world\hello_world.exe

如果编译成功,运行结果如下

Mediapipe – Windows10 编译Mediapipe C++版本保姆级教程-StubbornHuang Blog

如果能够编译并且运行成功hello world示例程序,那么说明你的Mediapipe的Windows C++编译环境配置完成,之后的就尽情的在上面做魔改吧!!!

3 Mediapipe功能封装成dll

我已经对Mediapipe的一些功能模块进行了封装,封装的教程如下:

代码已开源,相关的Github项目如下:https://github.com/HW140701/GoogleMediapipePackageDll