For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /pt/docs/mobile/troubleshooting.md (or send Accept: text/markdown).
Resolução de problemas da aplicação móvel
Corrige as falhas comuns de pré-visualização, configuração e build nativa antes de chegarem a um tester.
Instalação e configuração
Se a aplicação não alcança o backend, lembra-te de que localhost num telefone significa o telefone. Usa o endereço LAN do computador, 10.0.2.2 para o emulador Android ou um URL HTTPS de staging. Abre primeiro esse endereço no navegador do telefone; verifica Wi-Fi, firewall e VPN antes de alterar código. Um túnel Expo transporta o bundle do ecrã, não a tua API.
Um EXPO_PUBLIC_API_URL em falta ou errado aparece como erro de configuração antes do início de sessão. Um callback rejeitado significa normalmente que o esquema na build e MOBILE_ALLOWED_ORIGINS no servidor não coincidem, ou que o callback correu no Expo Go em vez da build nativa.
Fluxo de implementação
Depois de alterar uma dependência nativa ou o esquema, para o Metro, limpa a cache, reconstrói o cliente de desenvolvimento e reinstala a aplicação. Se apenas o JavaScript mudou, recarregar a pré-visualização basta. Mantém a versão do SDK Expo da aplicação alinhada com o Expo Go ou a build de desenvolvimento instalada no dispositivo.
Verificação e resolução de problemas
A pré-visualização, o início de sessão e o link profundo funcionam no dispositivo de destino.