Primeira execução
1. Inicie o gateway
Seção intitulada “1. Inicie o gateway”android-emu-webO gateway escuta em 127.0.0.1, na porta 7300 por padrão. Para usar outra porta, veja Linha de comando.
2. Deixe-o verificar seu Android SDK
Seção intitulada “2. Deixe-o verificar seu Android SDK”Ao iniciar, o gateway verifica o Android SDK, cmdline-tools, emulator, platform-tools, a imagem de sistema system-images;android-34;google_apis;arm64-v8a e pelo menos um dispositivo virtual (AVD). Ele mostra cada item que falta com uma correção, nesta ordem:
| Faltando | O que o gateway faz |
|---|---|
Android SDK ou cmdline-tools |
Mostra a página de download das ferramentas de linha de comando do Google e o diretório onde descompactá-las. Ele mesmo não faz esse download. |
emulator, platform-tools, imagem de sistema |
Mostra o comando sdkmanager e o tamanho aproximado, e então pergunta [y/N]. |
| Nenhum AVD | Oferece criar um dispositivo padrão chamado emu_web_default (perfil Pixel 5, 4096 MB de RAM), e então pergunta [y/N]. |
A resposta padrão é N. Nada é baixado ou criado a menos que você digite y. Se você responder N, o gateway mostra os comandos para que você mesmo os execute, e continua a inicialização.
As licenças do Android SDK precisam ser aceitas antes que o sdkmanager instale pacotes. sdkmanager --licenses as exibe no seu Terminal, e você mesmo as aceita.
Por exemplo, para instalar a imagem de sistema manualmente:
sdkmanager "system-images;android-34;google_apis;arm64-v8a"3. Abra a página
Seção intitulada “3. Abra a página”O gateway cria um novo token aleatório toda vez que é iniciado e abre seu navegador padrão em um endereço como este:
https://droid.devpier.dev/app/#port=7300&token=<token>A porta e o token ficam depois de #, então o navegador não os envia ao servidor web. A página os salva no navegador e os remove da barra de endereços. Se o seu navegador padrão não for o Chrome nem o Edge, copie o endereço do Terminal para o Chrome ou o Edge.
4. Permita o acesso à rede local
Seção intitulada “4. Permita o acesso à rede local”Na primeira vez que a página se conecta ao gateway no seu Mac, o Chrome mostra uma solicitação de permissão perguntando se droid.devpier.dev pode acessar sua rede local. Permita. O Chrome lembra a escolha para o site.
Se você negou, veja Solução de problemas.
5. Use o emulador
Seção intitulada “5. Use o emulador”Se um emulador com gRPC já estiver em execução, a página mostra a tela dele.
Caso contrário, escolha um dispositivo na lista e inicie-o. Veja Dispositivos.
Clique na tela para dar a ela o foco do teclado. Depois:
- Clique para tocar; arraste para deslizar.
- Digite no teclado do seu Mac. Veja Teclado e entrada.
- Use os botões Voltar, Início e Recentes acima da tela.
Pressione Ctrl+C no Terminal em que o gateway está rodando. Os emuladores em execução continuam rodando. Na próxima vez que você iniciar o gateway, ele se conecta a eles novamente.
A página local alternativa
Seção intitulada “A página local alternativa”O gateway também serve a mesma página em http://127.0.0.1:7300/app/ (ou na porta que você escolheu). Use-a se a página pública não carregar ou não conseguir se conectar.