PWA Troubleshooting Guide
Wenn die App hakt: Cache leeren, neu installieren oder Browser-Wechsel. Erste Hilfe bei PWA-Problemen.
Progressive Web Apps (PWA) sind modern, aber manchmal zickig. Wenn die Kamera schwarz bleibt, die Installation nicht klappt oder die App "offline" anzeigt, obwohl Sie Netz haben – hier ist die Erste Hilfe.
1. Kamera-Zugriff verweigert
Symptom: Sie klicken auf "Scannen", aber der Bildschirm bleibt schwarz oder zeigt eine Fehlermeldung.
Ursache: Sie haben dem Browser einmalig den Zugriff verweigert ("Blockieren").
Lösung iOS (Safari):
- Einstellungen > Safari > Kamera.
- Stellen Sie sicher, dass hier "Fragen" oder "Erlaube" gewählt ist.
- Laden Sie die Seite neu (Reload).
Lösung Android (Chrome):
- Tippen Sie auf das Schloss-Icon 🔒 links neben der URL.
- Gehen Sie auf "Berechtigungen".
- Setzen Sie den Schalter bei "Kamera" auf aktiv.
2. "App installieren" fehlt
Symptom: Sie finden den Button zur Installation nicht.
Lösung:
- iOS: Tippen Sie unten auf den "Teilen"-Button (Viereck mit Pfeil nach oben). Scrollen Sie herunter bis zu "Zum Home-Bildschirm". (Dies geht NUR in Safari, nicht in Chrome für iOS!).
- Android: Tippen Sie oben rechts auf die drei Punkte (Menü) > "App installieren".
3. Update-Probleme & Caching
Symptom: Wir haben ein neues Feature released, aber Sie sehen es nicht.
Ursache: Der "Service Worker" hält die alte Version hartnäckig im Cache, damit die App offline funktioniert.
Der "Hard Reload":
- Schließen Sie den Tab / die App komplett (aus dem Task-Manager wischen).
- Öffnen Sie sie neu.
- Warten Sie ~5 Sekunden.
- Laden Sie die Seite noch einmal neu.
Wenn das nicht hilft: Einstellungen > Browserdaten löschen > "Bilder und Dateien im Cache".
4. iOS 16/17 Bugs
Apple hat in neueren iOS-Versionen manchmal Probleme mit PWAs, die im Hintergrund offen bleiben. Wenn die App einfriert: Abschießen (nach oben wischen) und neu starten. Das löst 99% aller Speicher-Probleme.