PWA Troubleshooting Guide

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.