-
Notifications
You must be signed in to change notification settings - Fork 0
User de Troubleshooting FAQ
- Land prüfen. Einstellungen → Land. Ein für Deutschland gespeichertes Profil ruft die deutsche API auf; wenn du nach Frankreich reist, wechsle das Land. Die App unterstützt 17 Länder — stelle sicher, dass du das richtige gewählt hast.
- Verbindung prüfen. Offline → keine Live-Preise. Die App fällt auf die zwischengespeicherten letzten Preise zurück (rot als veraltet gekennzeichnet).
- Länder-API-Ausfall. Behörden-APIs sind manchmal nicht erreichbar. Versuche es in ein paar Minuten erneut. Prüfe downdetector oder die Seite GitHub Issues.
- Cache veraltet. Zum Aktualisieren nach unten ziehen oder die Aktualisieren-Schaltfläche antippen. Die App versucht die API erneut.
Die App hat eine einzelne zentrale Such-Schaltfläche in der unteren Navigationsleiste — er ist der einzige Suchauslöser über alle Tabs hinweg.
- In jedem Tab → tippe ihn an, um in den Suchbereich zu springen.
- In Suchergebnissen oder Kartenansicht → öffnet er das Kriterien-Blatt (Kraftstoff, Radius, Quelle).
- Innerhalb des Kriterien-Blatts → ein erneutes Tippen startet die Suche.
Die alten Schaltflächen "In der Nähe suchen" und "Entlang der Route suchen" innerhalb der Ergebnisliste wurden entfernt. Wenn die Schaltfläche ausgegraut aussieht, bist du meist im Routenmodus ohne eingetragenes Ziel.
- Du brauchst einen kostenlosen API-Key von creativecommons.tankerkoenig.de.
- Das Key-Format ist eine UUID:
00000000-0000-0000-0000-000000000002. - Füge ihn in Einstellungen → API-Keys → Deutschland ein.
- Wenn es weiter fehlschlägt, wurde der Key evtl. durch starke Nutzung ratenbegrenzt. Der Dienst begrenzt pro Key — teile Keys nicht öffentlich.
- Öffne die Android-Einstellungen → Standort → einschalten. Erteile der App die Berechtigung Bei Nutzung.
- Drinnen? GPS kann drinnen keinen Fix bekommen. Geh nach draußen oder verwende die Postleitzahl-Suche.
- Wenn die App sagt "Nur grober Standort" — aktiviere präzisen Standort in den Systemeinstellungen.
- Der Routing-Dienst (OSRM) ist öffentlich und manchmal langsam.
- Eine Mehrländer-Route kann Teilergebnisse streamen — das Banner oben zeigt, welche Länder noch antworten. Du kannst ein Ergebnis antippen, sobald es erscheint.
- Erneut versuchen. Die App speichert die Polylinie zwischen, sodass der zweite Versuch meist sofort ist.
- Wenn du dauerhaft Timeouts siehst, melde ein Issue mit Start/Ziel.
Beim Scannen wird nichts gefunden:
- Die Auto-Zündung muss an sein (Zubehör oder Run, nicht aus). Laufender Motor geht.
- Die Adapter-LED muss an und konstant leuchten (bei den meisten Modellen blau). Wenn sie blinkt oder aus ist, neu einstecken.
- Bluetooth muss am Telefon aktiviert sein.
- Android 12+: Hast du Bluetooth-Scan und Bluetooth-Verbindung erteilt? Öffne Android-Einstellungen → Apps → Sparkilo → Berechtigungen.
- Android 11-: Die App benötigt die Berechtigung Standort, um BLE-Geräte aufzuzählen (eine OS-Eigenheit — die App zeichnet dafür nie deinen Standort auf).
Adapter sichtbar, aber Verbindung schlägt fehl:
- Fehler "Reagiert nicht" — billiger Klon. 30 s warten, erneut versuchen. Versuche, den Motor kurz vollständig zu starten.
- Fehler "Protokoll-Init fehlgeschlagen" — gefälschter ELM327-Chip. Probiere ein anderes Adaptermodell; der vLinker FS ist eine zuverlässige günstige Option.
- Fehler "Berechtigung verweigert" — in den Systemeinstellungen erneut erteilen; manche Android-Versionen vergessen Bluetooth-Berechtigungen nach einem Neustart.
Verbindet, aber Kilometerstand zeigt 0 oder falsch:
- Dein Auto stellt evtl. PID A6 nicht bereit. Die App versucht es mit PID 31 und herstellerspezifischem Mode 22 (VIN-basiert) erneut.
- Manche älteren europäischen Autos (vor 2008) geben den Kilometerstand über OBD2 gar nicht heraus. Du musst ihn eintippen.
Auto-Aufzeichnung erfordert:
- Adapter mit einem Fahrzeug gekoppelt — das erste manuelle Pairing erstellt die Zuordnung.
- Auto-Aufzeichnung aktiviert in Einstellungen → OBD2 → Auto-Aufzeichnung.
- Telefon-Bluetooth an, ohne dass die System-Akku-Optimierung die App killt.
iOS: Das vom Betriebssystem nötige Hintergrund-Wakeup für "Auto-Verbindung beim Einschalten des Adapters" ist noch in Arbeit (#1542). Bis dahin starten iOS-Nutzer Trajets manuell aus dem Tab Trajets. Android beherrscht heute den vollständigen freihändigen Ablauf.
Das Annäherungs-Overlay löst nur aus, während ein Trajet aufzeichnet und du innerhalb von profile.approachRadiusKm (Standard 1 km) einer Tankstelle bist. Wenn du verifizieren willst, dass die Oberfläche korrekt umschaltet, ohne zu fahren, öffne Einstellungen → Datenschutz-Dashboard → Annäherungs-Overlay testen — die Schaltfläche pusht einen synthetischen Im-Radius-Zustand für 30 s. Siehe Verbrauch & OBD2 → Annäherungs-Overlay für die vollständige Einrichtung.
- Systembenachrichtigungen aktiviert? Android-Einstellungen → Apps → Sparkilo → Benachrichtigungen → Zulassen.
- Telefon im Ultra-Energiesparmodus? Aggressive Android-Energiesparer killen den WorkManager. Whitelist die App: Einstellungen → Akku → nicht eingeschränkt.
- Telefon war zum geplanten Prüfzeitpunkt offline. Die Prüfung läuft im nächsten Netzwerkfenster.
- Der Preis ist tatsächlich noch nicht unter den Schwellenwert gefallen.
- Android begrenzt Widget-Aktualisierungen auf mindestens alle ~30 Min. Das ist Systemrichtlinie.
- Das Widget nutzt denselben Cache wie die App. Tippe am Widget selbst auf das Aktualisieren-Symbol — das lädt Preise im Hintergrund neu, ohne die App zu öffnen.
- Das Antippen des Widgets öffnet die richtige Tankstelle, ob die App per Kaltstart geöffnet wird oder bereits warm im Speicher liegt; wenn nicht, melde ein Issue mit deinem Telefonmodell und der Android-Version.
Auf Querformat-Telefonen und Tablets (Breite ≥ 600 dp) zeigt der Favoriten-Bildschirm die Favoritenliste und die Alarme-Liste nebeneinander mit einer vertikalen Trennlinie. In diesem Layout gibt es keinen Tab-Umschalter, weil beide Bereiche gleichzeitig sichtbar sind. Drehe zurück ins Hochformat, falls du den Tab-Umschalter bevorzugst.
- Die Schaltfläche befindet sich in Einstellungen → Datenschutz-Dashboard (früher hieß sie "Kopieren" — jetzt "Speichern" und schreibt tatsächlich nach Downloads).
- Prüfe, ob du beim ersten Speichern die Dateizugriffsberechtigung erteilt hast.
- Falls das Speichern fehlschlägt, fällt die App auf das Kopieren in die Zwischenablage zurück, damit die Aktion nie still nichts tut.
- Prüfe Einstellungen → Cache leeren (über die Android-Systemeinstellungen).
- Wenn der Absturz anhält, melde ein Issue mit: Android-Version, Telefonmodell, App-Version (aus Einstellungen → Über) und dem jüngsten Crash-Report (die App bietet beim nächsten Start Speichern an — die Datei liegt in Downloads).
Einstellungen → Daten → Alle Daten exportieren → JSON-Datei, geschrieben in den öffentlichen Downloads-Ordner. Verwahre sie sicher. Bei einer Neuinstallation Importieren auf demselben Bildschirm.
TankSync-Nutzer müssen das nicht tun — die Daten liegen auf deiner Supabase-Instanz. Beachte, dass Trajets nur synchronisieren, wenn du zusätzlich Trajets synchronisieren in den TankSync-Einstellungen aktiviert hast (es ist Opt-in).
- Passiert sporadisch bei schwachen Verbindungen.
- Wische nach unten, um die Karte zu aktualisieren.
- Wenn es nach Schließen und erneutem Öffnen der App weiterhin auftritt, ratenbegrenzen die OpenStreetMap-Kachelserver evtl. gerade; versuch es in ein paar Minuten erneut.
Einstellungen → Daten → App zurücksetzen. Löscht jede lokale Hive-Box und räumt den sicheren Speicher. Irreversibel. Wenn du TankSync verwendest, lösche zuerst dein Serverkonto: Einstellungen → TankSync → Konto löschen, oder lösche nur die Fahrtzeilen mit Alle synchronisierten Trajets vergessen.
Teilweise. Favoriten funktionieren offline (zuletzt bekannte Preise werden angezeigt). Suchen erfordern einen Netzwerkaufruf — neue Tankstellen kannst du ohne nicht entdecken. Karten cachen Kacheln, die du kürzlich angeschaut hast, sodass besuchte Gegenden laden.
- Bug melden: github.com/fdittgen-png/tankstellen/issues — verwende die Bug-Report-Vorlage. Hänge das gespeicherte Fehlerprotokoll aus dem Datenschutz-Dashboard an.
- Feature anfragen: Feature-Request-Vorlage oder zuerst in Discussions diskutieren.
- Datenschutz-Fragen: siehe PRIVACY.md.
👤 User Guide
🛠️ Developer Guide
Architecture
Code patterns
Quality
Deep dives
Reference
Workflow