构建 MediaPipe Python Wheel 软件包

本页介绍了如何构建 MediaPipe Wheel 软件包。您可以使用 wheel 软件包在本地 UNIX 机器Raspberry Pi 上安装 MediaPipe。

前提条件

如需构建 Python Wheel 软件包,您的系统需要满足以下要求:

  • 支持 Buildkit 的 Docker(版本 18 或更高版本)

Python 构建流水线已通过 Python 3.9、3.10、3.11 和 3.12 版的测试。

使用 Docker 调用 build

您可以使用我们发布到 MediaPipe 代码库中的某个 Docker 映像。我们提供三种不同的图片:

  • manylinux_2_28_x86_64 包含用于构建 Manylinux wheel 的构建流水线,这些 wheel 可在任何 x86_64 Unix 主机上运行。

  • mp_manylinux_aarch64rp4 包含用于构建支持 aarch64 的 Raspberry Wheel 的构建流水线。

  • Dockerfile 包含用于构建 C++ 框架的构建流水线。

x&6_64 的 Manylinux 映像

克隆 MediaPipe 代码库,然后使用以下命令为大多数 Unix 平台构建 Docker 映像。您可以修改命令,以针对映像中预安装的任何 Python 版本(目前为 3.9)进行构建3.10、3.11 和 3.12)。对于其他 Python 版本,您可以相应地修改 Dockerfile。

构建 Docker 映像:

$ DOCKER_BUILDKIT=1 docker build -f Dockerfile.manylinux_2_28_x86_64 -t mp_manylinux . --build-arg "PYTHON_BIN=/opt/python/cp312-cp312/bin/python3.12"

创建 Docker 容器:

$ docker create -ti --name mp_pip_package_container mp_manylinux:latest

将 Docker 容器文件复制到本地机器:

$ docker cp mp_pip_package_container:/wheelhouse/. wheelhouse/

删除 Docker 容器:

$ docker rm -f mp_pip_package_container

ARM 上的 Raspberry Pi 映像

克隆 MediaPipe 代码库,然后使用以下命令为 Raspberry Pi 平台构建 Docker 映像。Dockerfile 会从源代码安装 Python 3.12,并仅为此版本构建 wheel。对于其他 Python 版本,您可以相应地修改 Dockerfile。

构建 Docker 映像:

$ docker build -f Dockerfile.manylinux2014_aarch64rp4 -t mp_manylinux_aarch64rp4 .

创建 Docker 容器:

$ docker create -ti --name mp_pip_package_container mp_manylinux_aarch64rp4:latest

将 Docker 容器文件复制到本地机器:

$ docker cp mp_pip_package_container:/wheelhouse/. wheelhouse/

删除 Docker 容器:

$ docker rm -f mp_pip_package_container