本页介绍了如何构建 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