このページでは、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 イメージのいずれかを使用できます。次の 3 種類の画像があります。
manylinux_2_28_x86_64 には、任意の x86_64 Unix ホストで実行できる Manylinux ホイールをビルドするビルド パイプラインが含まれています。
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 をインストールし、このバージョンのホイールのみをビルドします。他の 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