Google MediaPipe 跨平台安装指南：从入门到实践

时武鹤

于 2025-06-01 09:01:13 发布

阅读量243

点赞数 4

本文链接：https://blog.youkuaiyun.com/gitblog_00123/article/details/148360028

版权

Google MediaPipe 跨平台安装指南：从入门到实践

mediapipe Cross-platform, customizable ML solutions for live and streaming media. 项目地址: https://gitcode.com/gh_mirrors/me/mediapipe

MediaPipe 是 Google 开源的一个跨平台多媒体处理框架，它能够帮助开发者快速构建复杂的机器学习管道。本文将详细介绍如何在主流操作系统上安装和配置 MediaPipe 开发环境。

环境准备

在开始安装前，请注意以下关键事项：

OpenCV 版本要求：推荐使用 OpenCV 3.x 至 4.1 版本，虽然 2.x 版本目前可用，但未来可能不再支持
TensorFlow 兼容性：如需使用 TensorFlow 计算器和示例应用，请注意 gcc/g++ 6.3 和 7.3 版本存在已知问题
Python 依赖：确保使用 Python 3.7 并安装 six 库（pip3 install --user six）

Linux (Debian/Ubuntu) 安装指南

1. 安装构建工具

首先需要安装 Bazel 构建系统。推荐使用 Bazelisk 作为 Bazel 的版本管理工具。

2. 获取 MediaPipe 源代码

cd $HOME
git clone --depth 1 https://github.com/google/mediapipe.git
cd mediapipe

3. 安装 OpenCV 和 FFmpeg

提供三种安装方式：

方式一：使用包管理器安装预编译版本

sudo apt-get install -y \
    libopencv-core-dev \
    libopencv-highgui-dev \
    libopencv-calib3d-dev \
    libopencv-features2d-dev \
    libopencv-imgproc-dev \
    libopencv-video-dev

对于 OpenCV 4.5 还需要额外安装：

sudo apt-get install -y libopencv-contrib-dev

方式二：使用自动化脚本构建 MediaPipe 提供了 setup_opencv.sh 脚本来自动完成 OpenCV 的编译和配置。

方式三：手动编译 OpenCV 可参考 OpenCV 官方文档进行手动编译，完成后需要修改 MediaPipe 的 WORKSPACE 和构建配置文件。

4. GPU 加速支持（可选）

如需在 Linux 桌面环境使用 GPU 加速：

sudo apt-get install mesa-common-dev libegl1-mesa-dev libgles2-mesa-dev

构建时使用以下参数替代 CPU 模式：

--copt -DMESA_EGL_NO_X11_HEADERS --copt -DEGL_NO_X11

5. 验证安装

运行 Hello World 示例：

export GLOG_logtostderr=1
# CPU 模式
bazel run --define MEDIAPIPE_DISABLE_GPU=1 \
    mediapipe/examples/desktop/hello_world:hello_world

CentOS 安装指南

CentOS 上的安装过程与 Debian/Ubuntu 类似，但需要注意：

使用 yum 安装 OpenCV 时，默认安装的是 2.4.5 版本，可能存在与 gstreamer 的兼容性问题
手动编译 OpenCV 后，需要修改 WORKSPACE 和相关构建文件以指向自定义安装路径

macOS 安装指南

1. 准备工作

安装 Homebrew
安装 Xcode 及命令行工具：xcode-select --install

2. 安装依赖

使用 Homebrew 安装 OpenCV 3：

brew install opencv@3
brew uninstall --ignore-dependencies glog  # 解决已知依赖问题

3. Python 环境配置

brew install python
sudo ln -s -f /usr/local/bin/python3.7 /usr/local/bin/python
pip3 install --user six

4. 验证安装

export GLOG_logtostderr=1
bazel run --define MEDIAPIPE_DISABLE_GPU=1 \
    mediapipe/examples/desktop/hello_world:hello_world

Windows 安装指南

Windows 支持目前处于实验阶段，Android 应用构建仍需使用 WSL。

1. 环境准备

安装 MSYS2 并添加 C:\msys64\usr\bin 到 PATH
安装必要工具：pacman -S git patch unzip
安装 Python 并确保可执行文件在 PATH 中
安装 Visual C++ Build Tools 2019 和 WinSDK

2. 配置 Bazel

设置必要的环境变量：

set BAZEL_VS=C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools
set BAZEL_VC=C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC