Primo avvio
1. Avvia il gateway
Sezione intitolata “1. Avvia il gateway”android-emu-webIl gateway è in ascolto su 127.0.0.1, sulla porta 7300 per impostazione predefinita. Per usare un’altra porta, vedi Riga di comando.
2. Lascia che controlli il tuo Android SDK
Sezione intitolata “2. Lascia che controlli il tuo Android SDK”All’avvio, il gateway controlla la presenza dell’Android SDK, di cmdline-tools, emulator, platform-tools, dell’immagine di sistema system-images;android-34;google_apis;arm64-v8a e di almeno un dispositivo virtuale (AVD). Stampa ogni elemento mancante con una soluzione, in quest’ordine:
| Mancante | Cosa fa il gateway |
|---|---|
Android SDK o cmdline-tools |
Stampa la pagina di download degli strumenti a riga di comando di Google e la directory in cui estrarli. Non li scarica da solo. |
emulator, platform-tools, immagine di sistema |
Stampa il comando sdkmanager e la dimensione approssimativa, poi chiede [y/N]. |
| Nessun AVD | Propone di creare un dispositivo predefinito chiamato emu_web_default (profilo Pixel 5, 4096 MB di RAM), poi chiede [y/N]. |
La risposta predefinita è N. Non viene scaricato né creato nulla a meno che tu non digiti y. Se rispondi N, il gateway stampa i comandi così puoi eseguirli tu stesso, e prosegue con l’avvio.
Le licenze dell’Android SDK devono essere accettate prima che sdkmanager installi pacchetti. sdkmanager --licenses le mostra nel tuo Terminale, e le accetti tu stesso.
Ad esempio, per installare manualmente l’immagine di sistema:
sdkmanager "system-images;android-34;google_apis;arm64-v8a"3. Apri la pagina
Sezione intitolata “3. Apri la pagina”Il gateway crea un nuovo token casuale a ogni avvio, e apre il tuo browser predefinito su un indirizzo come questo:
https://droid.devpier.dev/app/#port=7300&token=<token>Porta e token si trovano dopo #, quindi il browser non li invia al server web. La pagina li salva nel browser e li rimuove dalla barra degli indirizzi. Se il tuo browser predefinito non è Chrome o Edge, copia l’indirizzo dal Terminale in Chrome o Edge.
4. Consenti l’accesso alla rete locale
Sezione intitolata “4. Consenti l’accesso alla rete locale”La prima volta che la pagina si connette al gateway sul tuo Mac, Chrome mostra una richiesta di autorizzazione che chiede se droid.devpier.dev può accedere alla tua rete locale. Consentilo. Chrome ricorda la scelta per il sito.
Se l’hai negato, vedi Risoluzione dei problemi.
5. Usa l’emulatore
Sezione intitolata “5. Usa l’emulatore”Se è già in esecuzione un emulatore con gRPC, la pagina mostra il suo schermo.
Altrimenti scegli un dispositivo nell’elenco e avvialo. Vedi Dispositivi.
Fai clic sullo schermo per dargli il focus della tastiera. Poi:
- Fai clic per toccare; trascina per fare uno swipe.
- Scrivi con la tastiera del tuo Mac. Vedi Tastiera e input.
- Usa i pulsanti Indietro, Home e App recenti sopra lo schermo.
Arresto
Sezione intitolata “Arresto”Premi Ctrl+C nel Terminale in cui è in esecuzione il gateway. Gli emulatori in esecuzione continuano a funzionare. Al successivo avvio, il gateway si riconnette a essi.
La pagina locale di riserva
Sezione intitolata “La pagina locale di riserva”Il gateway serve anche la stessa pagina all’indirizzo http://127.0.0.1:7300/app/ (o sulla porta che hai scelto). Usala se la pagina pubblica non si carica o non riesce a connettersi.