-
Notifications
You must be signed in to change notification settings - Fork 0
User it Troubleshooting FAQ
- Controlla il tuo paese. Impostazioni → Paese. Un profilo salvato per la Germania chiamerà l'API tedesca; se stai viaggiando in Francia, cambia paese. L'app supporta 17 paesi — assicurati di aver scelto quello giusto.
- Controlla la connettività. Offline → niente prezzi in tempo reale. L'app fa fallback sugli ultimi prezzi conosciuti in cache (segnati come obsoleti in rosso).
- Outage dell'API di paese. Le API governative ogni tanto cadono. Riprova tra qualche minuto. Controlla downdetector o la pagina GitHub Issues.
- Cache obsoleta. Pull-to-refresh o tocca il pulsante di aggiornamento. L'app riprova con l'API.
L'app ha un singolo FAB centrale nella barra di navigazione in basso — è l'unico trigger di ricerca in tutte le schede.
- In qualsiasi scheda → toccalo per saltare al ramo Ricerca.
- Nei risultati di ricerca o nella vista Mappa → apre la scheda dei Criteri (carburante, raggio, sorgente).
- Dentro la scheda dei Criteri → un nuovo tocco avvia la ricerca.
I vecchi pulsanti "Cerca nei dintorni" e "Cerca lungo il percorso" dentro l'elenco risultati sono stati rimossi. Se il FAB sembra disattivato, di solito significa che sei in modalità percorso senza una destinazione compilata.
- Hai bisogno di una API key gratuita da creativecommons.tankerkoenig.de.
- Il formato chiave è un UUID:
00000000-0000-0000-0000-000000000002. - Incollala in Impostazioni → API key → Germania.
- Se continua a fallire, la chiave potrebbe essere stata rate-limited per uso pesante. Il servizio limita per chiave — non condividere chiavi pubblicamente.
- Apri Impostazioni Android → Posizione → attiva. Concedi all'app il permesso Durante l'uso.
- Sei al chiuso? Il GPS non si aggancia al chiuso. Esci o usa la ricerca per codice postale.
- Se l'app dice "Solo posizione approssimativa" — abilita la posizione precisa nelle impostazioni di sistema.
- Il servizio di routing (OSRM) è pubblico e a volte lento.
- Un percorso multi-paese può trasmettere risultati parziali — il banner in alto ti dice quali paesi stanno ancora rispondendo. Puoi toccare un risultato nel momento in cui appare.
- Riprova. L'app mette in cache la polilinea, quindi il secondo tentativo è di solito istantaneo.
- Se vedi timeout di continuo, apri un'issue con la partenza/destinazione che hai usato.
Niente trovato durante la scansione:
- L'accensione dell'auto deve essere on (accessori o run, non off). Motore acceso va bene.
- Il LED dell'adattatore deve essere acceso e fisso (blu per la maggior parte dei modelli). Se lampeggia o è spento, reinseriscilo.
- Il Bluetooth deve essere attivo sul telefono.
- Android 12+: hai concesso Bluetooth Scan e Bluetooth Connect? Apri Impostazioni Android → App → Tankstellen → Autorizzazioni.
- Android 11-: l'app ha bisogno del permesso Posizione per enumerare i dispositivi BLE (una stranezza dell'OS — l'app non registra mai la tua posizione per questo).
Adattatore visibile ma la connessione fallisce:
- Errore "Non risponde" — clone economico. Aspetta 30 s, riprova. Prova a far partire brevemente del tutto il motore.
- Errore "Init protocollo fallita" — chip ELM327 contraffatto. Prova un modello di adattatore diverso; vLinker FS è un'opzione economica affidabile.
- Errore "Permesso negato" — riconcedi nelle impostazioni di sistema; alcuni Android dimenticano i permessi Bluetooth dopo il riavvio.
Si connette ma l'odometro legge 0 o sbagliato:
- La tua auto potrebbe non esporre il PID A6. L'app riprova con PID 31 e Mode 22 del produttore (VIN-based).
- Alcune auto europee più vecchie (pre-2008) non espongono affatto l'odometro su OBD2. Dovrai digitarlo.
La registrazione automatica richiede:
- Adattatore associato a un veicolo — il primo pairing manuale crea l'associazione.
- Registrazione automatica abilitata in Impostazioni → OBD2 → Registrazione automatica.
- Bluetooth del telefono attivo, con l'ottimizzazione batteria di sistema che non sta uccidendo l'app.
iOS: il wake-up a livello OS in background necessario per "auto-connessione quando l'adattatore si accende" è ancora in lavorazione (#1542). Fino ad allora, gli utenti iOS avviano i tragitti manualmente dalla scheda Tragitti. Android gestisce oggi l'intero flusso hands-off.
L'overlay di avvicinamento si attiva solo mentre un tragitto è in registrazione e sei entro profile.approachRadiusKm (predefinito 1 km) da una stazione. Se vuoi verificare che la UI passi correttamente senza guidare, apri Impostazioni → Dashboard Privacy → Prova overlay di avvicinamento — il pulsante spinge uno stato sintetico in-radius per 30 s. Vedi Consumi e OBD2 → Overlay di avvicinamento per il setup completo.
- Notifiche di sistema abilitate? Impostazioni Android → App → Tankstellen → Notifiche → Consenti.
- Telefono in modalità ultra-risparmio batteria? I risparmiatori di energia aggressivi di Android uccidono WorkManager. Metti l'app in whitelist: Impostazioni → Batteria → non limitata.
- Il telefono era offline al momento del check programmato. Il check parte alla prossima finestra di rete.
- Il prezzo non è ancora effettivamente sceso sotto la soglia.
- Android limita gli aggiornamenti del widget a una volta ogni ~30 min minimo. È una policy di sistema.
- Il widget usa la stessa cache dell'app. Tocca l'icona di aggiornamento sul widget stesso — recupera i prezzi in background senza aprire l'app.
- Toccare il widget apre la stazione giusta sia che l'app sia chiusa a freddo sia che fosse già attiva in memoria; se non lo fa, apri un'issue con modello del telefono e versione Android.
Sui telefoni in orizzontale e sui tablet (larghezza ≥ 600 dp) la schermata Preferiti renderizza l'elenco preferiti e l'elenco avvisi affiancati con un divisore verticale. Non c'è uno switcher di schede in quel layout perché entrambi i pannelli sono visibili contemporaneamente. Ruota in verticale se preferisci lo switcher.
- Il pulsante è in Impostazioni → Dashboard Privacy (prima diceva "Copia" — ora è "Salva" e scrive davvero in Download).
- Controlla di aver concesso il permesso di accesso ai file al primo salvataggio.
- Se il salvataggio fallisce, l'app fa fallback copiando il log negli appunti, così l'azione non resta mai silenziosamente senza effetto.
- Controlla Impostazioni → Svuota cache (tramite le impostazioni di sistema Android).
- Se il crash persiste, apri un'issue con: versione Android, modello telefono, versione app (da Impostazioni → Informazioni) e l'ultimo crash report (l'app offre Salva al prossimo avvio — il file è in Download).
Impostazioni → Dati → Esporta tutti i dati → file JSON scritto nella cartella pubblica Download. Conservalo al sicuro. Alla reinstallazione, Importa dalla stessa schermata.
Gli utenti TankSync non devono fare questo — i dati vivono sulla tua istanza Supabase. Nota che i tragitti si sincronizzano solo se hai attivato anche Sincronizza tragitti nelle impostazioni TankSync (è opt-in).
- Capita sporadicamente con connessioni deboli.
- Swipe verso il basso per aggiornare la mappa.
- Se persiste dopo aver chiuso e riaperto l'app, i server tile di OpenStreetMap potrebbero essere rate-limiting; riprova tra qualche minuto.
Impostazioni → Dati → Resetta app. Cancella ogni box Hive locale e pulisce lo storage sicuro. Irreversibile. Se usi TankSync, elimina prima il tuo account server: Impostazioni → TankSync → Elimina account, oppure ripulisci solo le righe dei viaggi con Dimentica tutti i tragitti sincronizzati.
Parzialmente. I preferiti funzionano offline (mostrati gli ultimi prezzi conosciuti). Le ricerche richiedono una chiamata di rete — non puoi scoprire nuove stazioni senza. Le mappe mettono in cache i tile che hai visto di recente, così le aree che hai già visitato si caricano.
- Segnala un bug: github.com/fdittgen-png/tankstellen/issues — usa il template Bug Report. Allega l'error log salvato dalla Dashboard Privacy.
- Richiedi una funzionalità: template Feature Request, o discutine prima in Discussions.
- Domande sulla privacy: vedi PRIVACY.md.
👤 User Guide
🛠️ Developer Guide
Architecture
Code patterns
Quality
Deep dives
Reference
Workflow