Ao criar aplicativos mobile no Replit, você pode encontrar problemas com pré-visualizações, empacotamento ou dependências de pacotes. Este guia ajuda você a resolver problemas comuns, começando por soluções rápidas e avançando para etapas de depuração mais profundas.Documentation Index
Fetch the complete documentation index at: https://docs.replit.com/llms.txt
Use this file to discover all available pages before exploring further.
Soluções rápidas
Tente estas primeiro — elas resolvem a maioria dos problemas:| Problema | O que tentar |
|---|---|
| Mudanças não aparecem no celular | Agite o celular para abrir o menu do Expo e toque em Recarregar |
| Mudanças não aparecem na pré-visualização | Pressione R no console para reempacotar |
| Aplicativo travado ou sem resposta | Pare e reinicie o aplicativo pelo console |
Problemas comuns
Mudanças não aparecem no meu dispositivo
Mudanças não aparecem no meu dispositivo
Quando você faz mudanças mas não as vê no seu celular:
- Agite o celular para abrir o menu do desenvolvedor do Expo
- Toque em Recarregar para baixar novamente o pacote
Tela de erro vermelha no Expo Go
Tela de erro vermelha no Expo Go
Uma tela de erro vermelha geralmente indica um erro de JavaScript ou módulo ausente. Leia a mensagem de erro — ela frequentemente aponta para o arquivo e linha específicos.Causas comuns:
- Um pacote não está instalado ou está na versão errada
- Um módulo funciona na web, mas não no nativo (ou vice-versa)
- Erro de sintaxe no seu código
- Leia a mensagem de erro com atenção — ela muitas vezes diz exatamente o que há de errado
- Peça ao Agent para ajudar a corrigir o erro compartilhando a mensagem
- Se o erro mencionar um pacote específico, tente reinstalar as dependências (veja Reinstalar pacotes)
O aplicativo funciona na web, mas trava no celular (ou vice-versa)
O aplicativo funciona na web, mas trava no celular (ou vice-versa)
Alguns pacotes ou recursos funcionam de forma diferente entre plataformas. O React Native compila para três alvos: iOS, Android e web. Uma biblioteca que funciona na web pode não suportar o nativo, ou pode precisar de configuração diferente.O que tentar:
- Verifique se o pacote suporta sua plataforma na sua documentação
- Pergunte ao Agent: “Este pacote é compatível com o Expo Go?”
- Considere mover a funcionalidade para seu servidor se não for suportada no mobile
O QR code não escaneia ou o aplicativo não conecta
O QR code não escaneia ou o aplicativo não conecta
Verifique sua rede:
- Seu celular e computador devem estar na mesma rede WiFi
- Algumas redes corporativas ou públicas bloqueiam a conexão
npx expo start --tunnel no shell.Reinicie o Expo Go:
Feche o Expo Go completamente e reabra-o antes de escanear.A build demora muito tempo
A build demora muito tempo
A primeira build é sempre mais lenta porque não há cache. As builds subsequentes devem ser mais rápidas.O que afeta o tempo de build:
- Número de pacotes no seu projeto
- Primeira execução após limpar o cache
- Velocidade de rede ao baixar pacotes
Erros de módulo não encontrado
Erros de módulo não encontrado
Quando você vê “Não foi possível resolver o módulo” ou “Módulo não encontrado”:
- O pacote pode não estar instalado — peça ao Agent para instalá-lo
- O pacote pode estar instalado, mas o cache está desatualizado — limpe o cache
- O pacote pode não existir ou estar com nome incorreto — verifique o nome do pacote
Comandos de depuração
Quando as soluções rápidas não funcionam, esses comandos ajudam a redefinir vários caches e estados. Execute-os no Shell.Limpar o cache do Metro
O Metro é o empacotador que compila seu código React Native. Limpar seu cache força uma nova build. No shell, execute:Reinstalar pacotes
Se você estiver vendo erros de módulo ou incompatibilidades de versão, reinstalar os pacotes geralmente ajuda. No shell, execute:package.json.
Se o seu projeto usa um gerenciador de pacotes diferente (como
bun ou pnpm), use o comando de instalação apropriado: bun install ou pnpm install.Verificar incompatibilidades de versão
O Expo Doctor verifica seu projeto em busca de problemas comuns, como incompatibilidades de versão entre pacotes. No shell, execute:Redefinição completa
Quando nada mais funciona, uma redefinição completa limpa todos os caches e reinstala tudo.Opção nuclear: Comando de redefinição completa
Opção nuclear: Comando de redefinição completa
Este comando remove todos os caches e reinstala os pacotes do zero. Use-o como último recurso.O que isso faz:
rm -rf node_modules— Exclui os pacotes instaladosrm -rf .expo— Exclui o cache local do Exponpm cache clean --force— Limpa o cache global do npmnpm install— Reinstala todos os pacotesnpx expo start --clear— Inicia com um cache Metro limpo
Limpar o cache no seu dispositivo
Se o aplicativo no seu celular parecer preso com código antigo, mesmo após o recarregamento:- iOS: No Expo Go, vá para Configurações e toque em Limpar cache
- Android: Vá para Configurações > Aplicativos > Expo Go > Armazenamento > Limpar cache
Referência rápida
| Problema | Tente primeiro | Depois tente |
|---|---|---|
| Mudanças não aparecem | Agite o celular → Recarregar | Limpar cache do Metro |
| Erros do empacotador | npx expo start --clear | Excluir node_modules |
| Módulo não encontrado | Reinstalar dependências | Redefinição completa |
| Avisos de incompatibilidade de versão | Execute npx expo-doctor | Avalie as correções sugeridas |
| Novo pacote não funcionando | Reiniciar o servidor | Limpar cache do Metro |
| app.json alterado | Reiniciar o servidor | — |
Obtendo mais ajuda
Se você ainda estiver com dificuldades:- Pergunte ao Agent: Descreva o erro e o que você tentou. O Agent geralmente consegue diagnosticar e corrigir problemas.
- Verifique os documentos do Expo: O guia de solução de problemas do Expo cobre cenários adicionais.
- Pesquise o erro: Copie a mensagem de erro exata e pesquise — alguém provavelmente já encontrou isso antes.
Próximos passos
- Volte para Aplicativos Mobile Nativos
- Aprenda o fluxo completo de publicação: Crie e lance um aplicativo mobile