-
Notifications
You must be signed in to change notification settings - Fork 0
User pt Troubleshooting FAQ
- Verifica o teu país. Definições → País. Um perfil guardado para a Alemanha chamará a API alemã; se estás a viajar para França, muda de país. A aplicação suporta 17 países — certifica-te de que escolheste o correto.
- Verifica a ligação. Offline → sem preços em direto. A aplicação recorre aos últimos preços conhecidos em cache (marcados como antigos a vermelho).
- Falha da API do país. APIs governamentais caem por vezes. Tenta novamente daqui a alguns minutos. Verifica downdetector ou a página de GitHub Issues.
- Cache antiga. Puxa para atualizar ou toca no botão de atualizar. A aplicação volta a tentar a API.
A aplicação tem um único FAB central na barra de navegação inferior — é o único gatilho de pesquisa em todos os separadores.
- Em qualquer separador → toca para saltar para o ramo Pesquisa.
- Na vista de resultados de pesquisa ou Mapa → abre a folha de Critérios (combustível, raio, origem).
- Dentro da folha de Critérios → um novo toque executa a pesquisa.
Os antigos botões "Pesquisar perto" e "Pesquisar ao longo da rota" dentro da lista de resultados foram removidos. Se o FAB parecer esbatido, normalmente significa que estás em modo rota sem destino preenchido.
- Precisas de uma chave API gratuita em creativecommons.tankerkoenig.de.
- O formato da chave é um UUID:
00000000-0000-0000-0000-000000000002. - Cola-a em Definições → Chaves API → Alemanha.
- Se continuar a falhar, a chave pode ter sido limitada por uso pesado. O serviço limita por chave — não partilhes chaves publicamente.
- Abre Definições Android → Localização → liga. Dá à aplicação a permissão Enquanto em uso.
- Em ambiente interior? O GPS não fixa em interior. Vai para o exterior ou usa a pesquisa por código postal.
- Se a aplicação diz "Apenas localização aproximada" — ativa a localização precisa nas definições do sistema.
- O serviço de roteamento (OSRM) é público e por vezes lento.
- Uma rota multi-país pode fazer streaming de resultados parciais — o banner no topo indica que países ainda estão a responder. Podes tocar num resultado assim que aparece.
- Tenta novamente. A aplicação põe a polilinha em cache para que a segunda tentativa seja normalmente instantânea.
- Se vires timeouts consistentemente, abre uma issue com a origem/destino da rota que usaste.
Nada encontrado durante a pesquisa:
- A ignição do carro tem de estar ligada (acessório ou run, não off). O motor a trabalhar serve.
- O LED do adaptador tem de estar aceso e sólido (azul na maioria dos modelos). Se está a piscar ou apagado, encaixa-o novamente.
- O Bluetooth tem de estar ativo no telemóvel.
- Android 12+: concedeste Pesquisa Bluetooth e Ligação Bluetooth? Abre Definições Android → Apps → Tankstellen → Permissões.
- Android 11-: a aplicação precisa de permissão de Localização para enumerar dispositivos BLE (uma esquisitice do SO — a aplicação nunca regista a tua localização para isto).
Adaptador visível mas a ligação falha:
- Erro "Sem resposta" — clone barato. Espera 30 s, tenta de novo. Tenta arrancar o motor brevemente.
- Erro "Falha na inicialização do protocolo" — chip ELM327 falsificado. Tenta um modelo de adaptador diferente; vLinker FS é uma opção barata e fiável.
- Erro "Permissão negada" — concede de novo nas definições do sistema; alguns Androids esquecem as permissões Bluetooth depois de reiniciar.
Liga mas o odómetro lê 0 ou errado:
- O teu carro pode não expor o PID A6. A aplicação volta a tentar com o PID 31 e com o Mode 22 do fabricante (baseado em VIN).
- Alguns carros europeus mais antigos (pré-2008) não expõem o odómetro de todo via OBD2. Terás de o escrever.
A gravação automática requer:
- Adaptador emparelhado a um veículo — o primeiro emparelhamento manual cria a associação.
- Gravação automática ativada em Definições → OBD2 → Gravação automática.
- Bluetooth do telemóvel ligado, com a otimização de bateria do sistema a não matar a aplicação.
iOS: o acordar em segundo plano ao nível do SO necessário para "ligar automaticamente quando o adaptador é alimentado" ainda está em curso (#1542). Até lá, os utilizadores iOS começam os trajetos manualmente no separador Trajetos. Android trata hoje do fluxo totalmente sem intervenção.
A sobreposição de aproximação só dispara enquanto um trajeto está a ser gravado e estás dentro do profile.approachRadiusKm (predefinição 1 km) de uma estação. Se queres verificar que a interface muda corretamente sem conduzir, abre Definições → Painel de privacidade → Testar sobreposição de aproximação — o botão empurra um estado sintético dentro do raio durante 30 s. Vê Consumo e OBD2 → Sobreposição de aproximação para a configuração completa.
- Notificações do sistema ativadas? Definições Android → Apps → Tankstellen → Notificações → Permitir.
- Telemóvel em modo ultra-poupança? As poupanças agressivas do Android matam o WorkManager. Coloca a aplicação na lista permitida: Definições → Bateria → não restringida.
- O telemóvel estava offline na hora agendada da verificação. A verificação corre na próxima janela de rede.
- O preço ainda não desceu abaixo do limite.
- O Android limita as atualizações de widget a uma vez a cada ~30 min no mínimo. É política do sistema.
- O widget usa a mesma cache que a aplicação. Toca no ícone de atualizar no próprio widget — puxa os preços em segundo plano sem abrir a aplicação.
- Tocar no widget abre a estação correta quer a aplicação esteja morta a frio quer já quente na memória; se não abrir, abre uma issue com o teu modelo de telemóvel e versão do Android.
Em telemóveis em paisagem e em tablets (largura ≥ 600 dp) o ecrã Favoritos renderiza a lista de favoritos e a lista de alertas lado a lado com um divisor vertical. Não há seletor de separadores nesse layout porque ambos os painéis estão visíveis ao mesmo tempo. Roda de volta para retrato se preferires o seletor de separadores.
- O botão está em Definições → Painel de privacidade (costumava ser "Copiar" — agora é "Guardar" e escreve realmente em Transferências).
- Verifica que concedeste permissão de acesso a ficheiros na primeira gravação.
- Se a gravação falhar, a aplicação recorre a copiar o registo para a área de transferência para que a ação nunca falhe silenciosamente.
- Verifica Definições → Limpar cache (via definições de sistema Android).
- Se a crash persistir, abre uma issue com: versão Android, modelo do telemóvel, versão da aplicação (em Definições → Sobre) e o último relatório de crash (a aplicação oferece Guardar no próximo arranque — o ficheiro está em Transferências).
Definições → Dados → Exportar todos os dados → ficheiro JSON escrito na pasta pública Transferências. Guarda-o em local seguro. Na reinstalação, Importar no mesmo ecrã.
Os utilizadores de TankSync não precisam de fazer isto — os dados vivem na tua instância Supabase. Nota que os trajetos só sincronizam se também tiveres ligado Sincronizar trajetos nas definições do TankSync (é opt-in).
- Acontece esporadicamente em ligações fracas.
- Desliza para baixo para atualizar o mapa.
- Se persistir depois de fechar e reabrir a aplicação, os servidores de mosaicos do OpenStreetMap podem estar a limitar; tenta alguns minutos depois.
Definições → Dados → Repor aplicação. Apaga todas as boxes Hive locais e limpa o armazenamento seguro. Irreversível. Se usas o TankSync, elimina primeiro a tua conta de servidor: Definições → TankSync → Eliminar conta, ou limpa só as linhas de viagens com Esquecer todos os trajetos sincronizados.
Parcialmente. Os favoritos funcionam offline (são mostrados os últimos preços conhecidos). As pesquisas requerem uma chamada de rede — não podes descobrir novas estações sem uma. Os mapas põem em cache os mosaicos que viste recentemente, por isso áreas que já visitaste carregam.
- Reportar um bug: github.com/fdittgen-png/tankstellen/issues — usa o template Bug Report. Anexa o registo de erros guardado a partir do Painel de privacidade.
- Pedir uma funcionalidade: template Feature Request, ou discute primeiro em Discussions.
- Questões de privacidade: vê PRIVACY.md.
👤 User Guide
🛠️ Developer Guide
Architecture
Code patterns
Quality
Deep dives
Reference
Workflow