メインコンテンツまでスキップ

特定のブランチから Daemon をインストールする

警告

⚠️ 開発者およびテスター専用

このガイドでは、公式リリース前に特定の GitHub ブランチから Reachy Mini デーモンをインストールする方法を説明します。新機能やバグ修正をテストする目的で使用してください。

前提条件

  • Reachy Mini ロボットへの SSH アクセス([email protected]、パスワード: root
  • ロボットがあなたの Wi-Fi ネットワークに接続されていること(またはホットスポット経由でアクセス可能であること)

オプション A: ローカル開発セットアップ

備考

このオプションは、アクティブな開発と高速なデバッグサイクルを目的としています。システム全体のインストールに影響を与えることなく、安全に変更をテストできます。

⚠️ このオプションではアプリをインストールしないでください。ローカルの reachy_mini バージョンに対する変更は正しく反映されません。

手順:

  1. SSH でロボットに接続します:

    ssh [email protected]
    # Password: root
  2. 特定のブランチで Reachy Mini リポジトリをクローンします:

    git clone -b <branch-name> https://github.com/pollen-robotics/reachy_mini.git
    cd reachy_mini
  3. 仮想環境をセットアップします:

    uv venv --python /venvs/mini_daemon/bin/python .venv
    source .venv/bin/activate
    uv sync --extra gstreamer --extra wireless-version
  4. システムの daemon サービスを停止します:

    sudo systemctl stop reachy-mini-daemon
ヒント

この手順は、システムサービスが自動的に再起動するため、再起動のたびに繰り返す必要があります。

  1. テスト用にローカル daemon を起動します:
    reachy-mini-daemon --wireless-version

これで ~/reachy_mini 内のコードを変更し、システムインストールに影響を与えることなく変更をテストできます。

オプション B: システム全体へのカスタムインストール

備考

このオプションでは、reachy-mini のブランチビルドをシステム全体の daemon としてインストールします。エンドツーエンドの徹底的なテストに適しており、Reachy Mini Control からのシームレスなアプリインストールもサポートします。

手順:

  1. SSH でロボットに接続します:

    ssh [email protected]
    # Password: root
  2. daemon の仮想環境を有効化します:

    source /venvs/mini_daemon/bin/activate
  3. 特定のブランチをインストールします:

    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> をテストしたいブランチ名に置き換えます(例: developfeature/my-featurebugfix/issue-123)。

ここでは pip を使用する必要があります。uv pip installgit lfs と正しく動作しないためです。

  1. (バージョン ≤ 1.2.13 の場合のみ) /venvs/apps_venv を使って手順 2 と 3 を繰り返します。

  2. daemon サービスを再起動します:

    sudo systemctl restart reachy-mini-daemon
  3. インストールが成功したか確認します:

    pip show reachy-mini | grep Version

    インストールしたブランチに対応するバージョンが表示されるはずです。

工場出荷時バージョンへのロールバック

ブランチのインストールで問題が発生した場合は、工場出荷時の daemon を復元できます:

  1. 元の工場出荷時 daemon を再インストールするために、Bluetooth 経由で SOFTWARE_RESET コマンドをトリガーします
  2. 詳細な手順については、リセットガイド を参照してください

重要な注意事項

  • 異なるブランチインストール間を切り替える前に、作業内容をバックアップしてください
  • システム全体へのインストールを行う前に、ローカル開発モードで十分にテストしてください
  • インストール後は、journalctl -u reachy-mini-daemon -f を使ってシステムログを監視してください
  • パフォーマンスへの影響: 一部の開発ブランチでは、パフォーマンスや安定性が低下する場合があります
Loading Comments...