特定のブランチから Daemon をインストールする
⚠️ 開発者およびテスター専用
このガイドでは、公式リリース前に特定の GitHub ブランチから Reachy Mini デーモンをインストールする方法を説明します。新機能やバグ修正をテストする目的で使用してください。
前提条件
- Reachy Mini ロボットへの SSH アクセス(
[email protected]、パスワード:root) - ロボットがあなたの Wi-Fi ネットワークに接続されていること(またはホットスポット経由でアクセス可能であること)
オプション A: ローカル開発セットアップ
このオプションは、アクティブな開発と高速なデバッグサイクルを目的としています。システム全体のインストールに影響を与えることなく、安全に変更をテストできます。
⚠️ このオプションではアプリをインストールしないでください。ローカルの reachy_mini バージョンに対する変更は正しく反映されません。
手順:
-
SSH でロボットに接続します:
ssh [email protected]
# Password: root -
特定のブランチで Reachy Mini リポジトリをクローンします:
git clone -b <branch-name> https://github.com/pollen-robotics/reachy_mini.git
cd reachy_mini -
仮想環境をセットアップします:
uv venv --python /venvs/mini_daemon/bin/python .venv
source .venv/bin/activate
uv sync --extra gstreamer --extra wireless-version -
システムの daemon サービスを停止します:
sudo systemctl stop reachy-mini-daemon
この手順は、システムサービスが自動的に再起動するため、再起動のたびに繰り返す必要があります。
- テスト用にローカル daemon を起動します:
reachy-mini-daemon --wireless-version
これで ~/reachy_mini 内のコードを変更し、システムインストールに影響を与えることなく変更をテストできます。
オプション B: システム全体へのカスタムインストール
このオプションでは、reachy-mini のブランチビルドをシステム全体の daemon としてインストールします。エンドツーエンドの徹底的なテストに適しており、Reachy Mini Control からのシームレスなアプリインストールもサポートします。
手順:
-
SSH でロボットに接続します:
ssh [email protected]
# Password: root -
daemon の仮想環境を有効化します:
source /venvs/mini_daemon/bin/activate -
特定のブランチをインストールします:
pip install --no-cache-dir --force-reinstall \
"reachy_mini[gstreamer,wireless-version] @ git+https://github.com/pollen-robotics/reachy_mini.git@<branch-name>"<branch-name>をテストしたいブランチ名に置き換えます(例:develop、feature/my-feature、bugfix/issue-123)。
ここでは pip を使用する必要があります。uv pip install は git lfs と正しく動作しないためです。
-
(バージョン ≤ 1.2.13 の場合のみ)
/venvs/apps_venvを使って手順 2 と 3 を繰り返します。 -
daemon サービスを再起動します:
sudo systemctl restart reachy-mini-daemon -
インストールが成功したか確認します:
pip show reachy-mini | grep Versionインストールしたブランチに対応するバージョンが表示されるはずです。
工場出荷時バージョンへのロールバック
ブランチのインストールで問題が発生した場合は、工場出荷時の daemon を復元できます:
- 元の工場出荷時 daemon を再インストールするために、Bluetooth 経由で SOFTWARE_RESET コマンドをトリガーします
- 詳細な手順については、リセットガイド を参照してください
重要な注意事項
- 異なるブランチインストール間を切り替える前に、作業内容をバックアップしてください
- システム全体へのインストールを行う前に、ローカル開発モードで十分にテストしてください
- インストール後は、
journalctl -u reachy-mini-daemon -fを使ってシステムログを監視してください - パフォーマンスへの影響: 一部の開発ブランチでは、パフォーマンスや安定性が低下する場合があります