Solução de problemas

O Chrome bloqueou o acesso à rede local

A página em droid.devpier.dev se conecta ao gateway no seu próprio Mac. O Chrome pede permissão na primeira vez. Se você negou, a página não consegue se conectar e, após algumas tentativas sem sucesso, informa que o Chrome bloqueou o acesso ao seu Mac.

Para permitir novamente:

1. Abra no Chrome Configurações → Privacidade e segurança → Configurações do site.
2. Encontre droid.devpier.dev e permita o acesso à rede local.
3. Recarregue a página.

Se ainda não conseguir se conectar, use a página local alternativa.

Porta já em uso

O gateway escuta na porta 7300 por padrão. Se outro programa já usa essa porta, o gateway não consegue iniciar nela. Encontre o programa:

lsof -nP -iTCP:7300 -sTCP:LISTEN

Pare esse programa ou inicie o gateway em outra porta:

android-emu-web --port 7301

O gateway coloca a nova porta no endereço que abre, então a página se conecta à porta certa.

Nenhum emulador encontrado

Se a página disser que nenhum emulador em execução foi encontrado:

• Verifique se há um emulador em execução: adb devices deve listar emulator-5554 ou algo parecido.
• Verifique se ele foi iniciado com gRPC ativado (-grpc <port>). O gateway não consegue ler a tela de um emulador sem gRPC.

Você também pode iniciar um dispositivo pela lista na página. Veja Dispositivos.

O gateway continua rodando quando nenhum emulador é encontrado e mostra o motivo no Terminal.

Se o gateway informar que o Android SDK, emulator, platform-tools ou a imagem de sistema está faltando, siga a correção que ele mostra. Veja Primeira execução.

“sdkmanager” está faltando

Um SDK instalado pelo Android Studio pode não incluir cmdline-tools, que fornece sdkmanager e avdmanager. O gateway não faz esse download. Baixe as ferramentas de linha de comando do Google em developer.android.com e descompacte-as de forma que este caminho exista:

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

O token expirou

O gateway gera um novo token sempre que é iniciado. Se você reiniciar o gateway, uma página que ainda tem o token antigo mostra que o token não é mais válido e para de tentar novamente. Abra o novo link que o gateway mostrou ou execute o gateway de novo.

A página diz que o gateway ou a página está desatualizado

• Gateway desatualizado: execute o comando de atualização que a página mostra. É o mesmo comando de instalação.
• Página desatualizada: force o recarregamento da página com Cmd+Shift+R.

Navegador errado

A página funciona apenas no Chrome e no Edge. Em outros navegadores, ela pede que você troque de navegador e não tenta se conectar. Veja Suporte a navegadores.

Use a página local alternativa

O gateway serve a mesma página em http://127.0.0.1:7300/app/ (ou na porta que você escolheu). Use-a quando a página pública não carregar ou o acesso à rede local tiver sido negado.

A tela para de atualizar

Se o emulador fechar ou reiniciar, a página mostra que está desconectada. O gateway continua rodando. Quando o emulador volta, a página se reconecta e a tela retorna.