### 下载并安装最新版本的 MediaPipe 源代码 #### 准备工作 在开始之前，请确认已具备以下条件： - 已安装 Git，用于克隆 MediaPipe 的源代码仓库。 - 安装了 Python 3.7 或更高版本（推荐使用虚拟环境管理工具如 `venv` 或 `conda` 来隔离开发环境）。如果目标设备为树莓派，则建议选择带有 Python 3.7 的镜像以减少兼容性问题[^2]。 #### 步骤说明 ##### 1. 克隆 MediaPipe 源代码 通过运行以下命令来获取最新的 MediaPipe 源代码： ```bash git clone https://github.com/google/mediapipe.git cd mediapipe ``` 此操作会将官方 GitHub 上的 MediaPipe 存储库复制到本地文件夹中[^1]。 ##### 2. 设置 Python 开发环境 创建一个新的虚拟环境，并激活它： ```bash python3 -m venv mediapipe-env source mediapipe-env/bin/activate ``` 随后，在该环境中安装所需的依赖项。可以按照管理员指南中的描述执行以下命令以确保所有必需的系统级依赖均已就绪： ```bash sudo apt-get update sudo apt-get install -y build-essential cmake pkg-config zip unzip python3-dev python3-numpy libavcodec-dev libavformat-dev libswscale-dev libgstreamer-plugins-base1.0-dev libgstreamer1.0-dev ``` 这些包对于构建和运行 MediaPipe 至关重要[^3]。 ##### 3. 使用 Bazel 构建 MediaPipe MediaPipe 需要 Bazel 进行编译。可以通过以下方式安装 Bazel： ```bash echo "deb [arch=amd64] http://storage.googleapis.com/bazel-apt stable jdk1.8" | sudo tee /etc/apt/sources.list.d/bazel.list curl https://bazel.build/bazel-release.pub.gpg | sudo apt-key add - sudo apt-get update && sudo apt-get install bazel ``` 完成之后验证其版本号是否满足最低需求（通常至少需要 Bazle 版本 4.x 及以上）： ```bash bazel --version ``` 接着配置 Bazel 并启动实际构建过程： ```bash ./configure.sh bazel build -c opt //mediapipe/examples/desktop/hello_world:hello_world ``` ##### 4. 测试安装成果 成功构建后，可尝试运行示例程序检验设置是否正确： ```bash bazel-bin/mediapipe/examples/desktop/hello_world/hello_world ``` 如果一切正常，屏幕上应该显示 “Hello, MediaPipe!” 字样。 --- ### 注意事项 - 如果遇到任何错误提示关于缺少特定软件包或者不匹配的 API 接口定义等问题，请仔细检查是否有遗漏未安装的基础组件或更新文档链接是否存在差异。 - 对于非标准平台比如 ARM 设备上的部署可能还需要额外调整某些预设参数甚至重新编写部分脚本来适配硬件特性。