初回起動

1. ゲートウェイを起動する

android-emu-web

ゲートウェイはデフォルトで 127.0.0.1、ポート 7300 をリッスンします。別のポートを使用する場合はコマンドラインを参照してください。

2. Android SDK の確認を行う

起動時に、ゲートウェイは Android SDK・cmdline-tools・emulator・platform-tools・システムイメージ system-images;android-34;google_apis;arm64-v8a・少なくとも 1 つの仮想デバイス（AVD）の有無を確認します。不足しているものがあれば、次の順序で修正方法を表示します。

不足しているもの	ゲートウェイの対応
Android SDK または cmdline-tools	Google のコマンドラインツールのダウンロードページと解凍先ディレクトリを表示します。ゲートウェイ自身はダウンロードしません。
emulator・platform-tools・システムイメージ	sdkmanager コマンドとおおよそのサイズを表示し、[y/N] を尋ねます。
AVD なし	デフォルトデバイス emu_web_default（Pixel 5 プロファイル、4096 MB RAM）の作成を提案し、[y/N] を尋ねます。

デフォルトの答えは N です。y を入力しない限り、何もダウンロードも作成もされません。N を答えた場合、ゲートウェイはコマンドを表示して自分で実行できるようにし、起動を続けます。

sdkmanager でパッケージをインストールする前に、Android SDK ライセンスに同意する必要があります。sdkmanager --licenses でターミナルにライセンスが表示され、自分で同意します。

たとえば、システムイメージを手動でインストールするには次のコマンドを実行します。

sdkmanager "system-images;android-34;google_apis;arm64-v8a"

3. ページを開く

ゲートウェイは起動するたびに新しいランダムなトークンを生成し、次のような形式のアドレスでデフォルトブラウザを開きます。

https://droid.devpier.dev/app/#port=7300&token=<token>

ポートとトークンは # の後にあるため、ブラウザは Web サーバーに送信しません。ページはそれをブラウザに保存し、アドレスバーから削除します。デフォルトブラウザが Chrome または Edge でない場合、ターミナルに表示されたアドレスを Chrome または Edge にコピーして開いてください。

4. ローカルネットワークアクセスを許可する

ページが Mac 上のゲートウェイに初めて接続するとき、Chrome は droid.devpier.dev がローカルネットワークにアクセスしてよいかを尋ねるパーミッションプロンプトを表示します。許可してください。Chrome はそのサイトの選択を記憶します。

拒否した場合はトラブルシューティングを参照してください。

5. エミュレーターを使う

gRPC が有効なエミュレーターがすでに起動中であれば、ページにその画面が表示されます。

そうでなければ、リストからデバイスを選んで起動してください。デバイスを参照してください。

画面をクリックしてキーボードフォーカスを与えます。その後：

• クリックでタップ、ドラッグでスワイプ。
• Mac のキーボードで入力。キーボードと入力を参照してください。
• 画面上部の戻る・ホーム・履歴ボタンを使用。

停止する

ゲートウェイを実行しているターミナルで Ctrl+C を押します。起動中のエミュレーターはそのまま動き続けます。次回ゲートウェイを起動すると、再び接続されます。

ローカルフォールバックページ

ゲートウェイは同じページを http://127.0.0.1:7300/app/（または選択したポート）でも提供します。公開ページが読み込めない場合や接続できない場合に使用してください。