PWA Troubleshooting Guide

Die App lässt sich nicht installieren? Der Offline-Modus streikt? Hier sind die Lösungen für die häufigsten Probleme mit Progressive Web Apps (PWAs).

1. "Zum Startbildschirm"-Button fehlt

• iOS: Sie müssen Safari nutzen. Chrome, Firefox oder In-App-Browser (z.B. aus LinkedIn heraus geöffnet) unterstützen die Installation unter iOS oft nicht.
• Android: Nutzen Sie Chrome.
• Privater Modus: Im "Incognito / Private" Modus ist die Installation meist deaktiviert. Wechseln Sie in einen normalen Tab.

2. Alte Daten werden angezeigt (Cache)

PWAs speichern die App-Dateien aggressiv im Cache, um schnell zu sein. Manchmal "klemmt" ein Update.

• Reload erzwingen: Ziehen Sie die Seite nach unten (Pull-to-Refresh) oder drücken Sie Strg + F5 (Desktop).
• Update-Benachrichtigung: Kontakte.me zeigt unten rechts einen Toast "Neue Version verfügbar", wenn ein Update erkannt wurde. Klicken Sie auf "Aktualisieren".

3. Storage Limit erreicht

Der Browser begrenzt den Speicherplatz für Webseiten (oft 50-100 MB).

• Wenn Sie tausende Bilder-Scans lokal speichern, kann das Limit voll laufen.
• Lösung: Exportieren Sie alte Kontakte (Backup) und löschen Sie sie aus der App, um Platz zu schaffen.
• Prüfung: In den Browser-Einstellungen unter "Webseitendaten" können Sie sehen, wie viel Platz kontakte.me belegt.

4. Kamera-Zugriff verweigert

Der Scanner bleibt schwarz?

• Haben Sie beim ersten Start "Darf Kamera nutzen?" abgelehnt?
• Lösung iOS: Einstellungen -> Safari -> Kamera -> Auf "Fragen" oder "Erlauben" stellen.
• Lösung Android: Chrome Einstellungen -> Website-Einstellungen -> Kamera.

5. App öffnet sich immer im Browser

Sie haben das Icon auf dem Homescreen, aber es öffnet sich trotzdem Safari/Chrome mit Adressleiste?

• Das passiert, wenn die manifest.json nicht richtig geladen wurde.
• Löschen Sie das Icon und installieren Sie die App neu (Add to Homescreen). Achten Sie darauf, dass die Seite fertig geladen ist, bevor Sie installieren.