Erster Start

1. Gateway starten

android-emu-web

Das Gateway lauscht auf 127.0.0.1, standardmäßig auf Port 7300. Wie Sie einen anderen Port verwenden, steht unter Befehlszeile.

2. Android SDK prüfen lassen

Beim Start prüft das Gateway, ob das Android SDK, cmdline-tools, emulator, platform-tools, das Systemabbild system-images;android-34;google_apis;arm64-v8a und mindestens ein virtuelles Gerät (AVD) vorhanden sind. Jedes fehlende Element gibt es mit einer Lösung aus, in dieser Reihenfolge:

Fehlt	Was das Gateway tut
Android SDK oder cmdline-tools	Gibt die Downloadseite für Googles Befehlszeilentools und das Verzeichnis aus, in das Sie sie entpacken. Diese lädt es nicht selbst herunter.
emulator, platform-tools, Systemabbild	Gibt den sdkmanager-Befehl und die ungefähre Größe aus und fragt dann [y/N].
Kein AVD	Bietet an, ein Standardgerät namens emu_web_default zu erstellen (Profil Pixel 5, 4096 MB RAM), und fragt dann [y/N].

Die Standardantwort ist N. Es wird nichts heruntergeladen oder erstellt, solange Sie nicht y eingeben. Wenn Sie mit N antworten, gibt das Gateway die Befehle aus, damit Sie sie selbst ausführen können, und setzt den Start fort.

Die Lizenzen des Android SDK müssen akzeptiert sein, bevor sdkmanager Pakete installiert. sdkmanager --licenses zeigt sie in Ihrem Terminal an, und Sie akzeptieren sie selbst.

Zum Beispiel, um das Systemabbild manuell zu installieren:

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

3. Seite öffnen

Das Gateway erzeugt bei jedem Start ein neues zufälliges Token und öffnet Ihren Standardbrowser mit einer Adresse wie dieser:

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

Port und Token stehen nach #, daher sendet der Browser sie nicht an den Webserver. Die Seite speichert sie im Browser und entfernt sie aus der Adressleiste. Wenn Ihr Standardbrowser nicht Chrome oder Edge ist, kopieren Sie die Adresse aus dem Terminal in Chrome oder Edge.

4. Zugriff auf das lokale Netzwerk erlauben

Wenn sich die Seite zum ersten Mal mit dem Gateway auf Ihrem Mac verbindet, zeigt Chrome eine Berechtigungsabfrage, ob droid.devpier.dev auf Ihr lokales Netzwerk zugreifen darf. Erlauben Sie es. Chrome merkt sich die Entscheidung für die Website.

Wenn Sie es abgelehnt haben, siehe Fehlerbehebung.

5. Emulator verwenden

Wenn bereits ein Emulator mit gRPC läuft, zeigt die Seite seinen Bildschirm.

Andernfalls wählen Sie ein Gerät in der Liste aus und starten es. Siehe Geräte.

Klicken Sie auf den Bildschirm, damit er den Tastaturfokus erhält. Dann:

• Klicken zum Tippen; Ziehen zum Wischen.
• Schreiben Sie mit der Tastatur Ihres Macs. Siehe Tastatur und Eingabe.
• Verwenden Sie die Tasten Zurück, Startbildschirm und Letzte Apps über dem Bildschirm.

Stoppen

Drücken Sie Ctrl+C in dem Terminal, in dem das Gateway läuft. Laufende Emulatoren laufen weiter. Beim nächsten Start des Gateways verbindet es sich wieder mit ihnen.

Die lokale Ersatzseite

Das Gateway stellt dieselbe Seite auch selbst unter http://127.0.0.1:7300/app/ bereit (oder unter dem Port, den Sie gewählt haben). Verwenden Sie sie, wenn die öffentliche Seite nicht lädt oder keine Verbindung herstellen kann.