Risoluzione dei problemi

Chrome ha bloccato l’accesso alla rete locale

La pagina su droid.devpier.dev si connette al gateway sul tuo Mac. Chrome chiede l’autorizzazione la prima volta. Se l’hai negata, la pagina non riesce a connettersi e, dopo alcuni tentativi falliti, ti avvisa che Chrome ha bloccato l’accesso al tuo Mac.

Per consentirlo di nuovo:

1. Apri in Chrome Impostazioni → Privacy e sicurezza → Impostazioni sito.
2. Trova droid.devpier.dev e consenti l’accesso alla rete locale.
3. Ricarica la pagina.

Se ancora non riesci a connetterti, usa la pagina locale di riserva.

Porta già in uso

Il gateway è in ascolto sulla porta 7300 per impostazione predefinita. Se un altro programma usa già quella porta, il gateway non può avviarsi su di essa. Trova il programma:

lsof -nP -iTCP:7300 -sTCP:LISTEN

Arresta quel programma, oppure avvia il gateway su un’altra porta:

android-emu-web --port 7301

Il gateway inserisce la nuova porta nell’indirizzo che apre, così la pagina si connette alla porta giusta.

Nessun emulatore trovato

Se la pagina dice che non è stato trovato nessun emulatore in esecuzione:

• Controlla che un emulatore sia in esecuzione: adb devices dovrebbe elencare emulator-5554 o simile.
• Controlla che sia stato avviato con gRPC abilitato (-grpc <port>). Il gateway non può leggere lo schermo di un emulatore senza gRPC.

Puoi anche avviare un dispositivo dall’elenco nella pagina. Vedi Dispositivi.

Il gateway continua a funzionare quando non trova nessun emulatore, e stampa il motivo nel Terminale.

Se il gateway segnala che mancano l’Android SDK, emulator, platform-tools o l’immagine di sistema, segui la soluzione che stampa. Vedi Primo avvio.

Manca «sdkmanager»

Un SDK installato da Android Studio potrebbe non includere cmdline-tools, che fornisce sdkmanager e avdmanager. Il gateway non lo scarica. Scarica gli strumenti a riga di comando di Google da developer.android.com ed estraili in modo che esista questo percorso:

<your SDK>/cmdline-tools/latest/bin/sdkmanager

Il token è scaduto

Il gateway crea un nuovo token a ogni avvio. Se riavvii il gateway, una pagina che ha ancora il vecchio token mostra che il token non è più valido e smette di riprovare. Apri il nuovo link stampato dal gateway, oppure esegui di nuovo il gateway.

La pagina dice che il gateway o la pagina non sono aggiornati

• Gateway non aggiornato: esegui il comando di aggiornamento mostrato dalla pagina. È lo stesso del comando di installazione.
• Pagina non aggiornata: forza il ricaricamento della pagina con Cmd+Shift+R.

Browser sbagliato

La pagina funziona solo in Chrome ed Edge. Negli altri browser ti chiede di cambiare browser e non tenta di connettersi. Vedi Browser supportati.

Usa la pagina locale di riserva

Il gateway serve la stessa pagina all’indirizzo http://127.0.0.1:7300/app/ (o sulla porta che hai scelto). Usala quando la pagina pubblica non si carica o l’accesso alla rete locale è stato negato.

Lo schermo smette di aggiornarsi

Se l’emulatore si chiude o si riavvia, la pagina mostra che è disconnessa. Il gateway continua a funzionare. Quando l’emulatore torna disponibile, la pagina si riconnette e lo schermo ricompare.