Solução de problemas

Reúne os erros mais reportados e o caminho para resolver cada um. Se o seu problema não estiver aqui, abra uma issue com o template de bug (em português ou inglês) — quanto mais contexto (versão do app, modelo do aparelho, passos para reproduzir), mais rápido o conserto.

Erro ao iniciar: "Cannot read properties of undefined (reading 'bind')"

Causa: nas versões anteriores a 1.4.3, um plugin interno tentava acessar a ponte do Cordova antes de ela existir em alguns aparelhos/WebViews, derrubando a inicialização. Solução: atualize para a v1.4.3 ou superior ([[Instalacao]]). Se ainda ocorrer: Sobre › toque 7 vezes na versão › menu dev › Limpar cache, reinicie e, persistindo, reporte com o log copiado (o próprio menu dev tem "copiar build info").

"Failed to load changelog" na página Sobre/Changelog

Causa: versões antigas buscavam o changelog do repositório errado (404). Solução: a partir da v1.4.2 o app lê o CHANGELOG.md oficial e falha em silêncio quando está offline — você sempre verá o changelog local embutido. Sem rede, essa mensagem é esperada e inofensiva.

Troca de idioma não aplica / traduções faltando

A partir da v1.4.2 a troca de idioma é imediata (sem reiniciar) e a primeira execução usa português quando o idioma do sistema não é reconhecido. Se você encontrar um texto sem tradução, reporte em uma issue — a varredura npm run lang:check compara os 31 idiomas contra o inglês e o português fica sempre em 100%.

Git: login não conclui / "Bad credentials"

• Gere um novo login (Sair e Entrar com GitHub de novo) — códigos do device flow expiram em ~15 minutos.
• Verifique em github.com/settings/applications se o app não foi revogado.
• Rede corporativa/VPN podem bloquear o endpoint do OAuth; tente outra rede.
• Rate limit 403 sem login é normal: a cota anônima é compartilhada.

IA: erro 401/404, respostas cortadas

Veja a seção de problemas na página Assistente de IA — na prática, 90% dos casos são token inválido (401) ou URL base errada (404).

Terminal não abre ou fica em branco

• Feche e reabra o painel (Ctrl-` ).
• Alguns WebViews antigos falham com o xterm — atualize o WebView do Android (Play Store › Android System WebView) e reinicie o aparelho.
• Persistindo, reporte com o modelo do aparelho e versão do Android.

App lento / cache grande

No menu de desenvolvedor (Sobre › 7 toques na versão) use Limpar cache. Projetos gigantes (node_modules!) abertos no explorador pesam — prefira abrir a pasta do código em si. O cache pode ser limpo com segurança: nenhum projeto ou configuração é apagado.

Diagnóstico rápido — checklist do menu dev

1. Sobre → toque 7× no número da versão (menu oculto abre com uma vibração longa).
2. Copiar build info — cole na issue; traz versão, plataforma e build.
3. Limpar cache → Reiniciar — resolve a maioria dos estados estranhos.
4. Console — erros em vermelho aqui são a melhor pista para o bug report.