Reconnect-API
Füge deiner Offline-Fallback-Seite einen „Erneut versuchen“-Button hinzu, der die letzte Online-URL deiner iOS-App neu lädt.
Die Reconnect-API lädt die letzte Online-URL neu, auf der sich der Nutzer befand, bevor deine App auf die Offline-HTML-Seite zurückgefallen ist. Sie ist als „Erneut versuchen“-Button auf deinem eigenen Offline-/Fallback-Screen gedacht.
Verwendung:
Füge den Trigger auf deiner Offline-Seite ein (typischerweise local-html/index.html):
<button onclick="window.location.href='reconnect://'">Erneut verbinden</button>
So funktioniert es:
Die App merkt sich die zuletzt erfolgreich geladene URL. Tippt der Nutzer auf reconnect://, navigiert die WebView zurück zu dieser URL. Besteht weiterhin keine Verbindung, wird erneut deine Fallback-Seite angezeigt.
Zugehörige Konfiguration:
offlinelocalhtmlswitchin Config.swift muss auftruegesetzt sein, und du benötigst einelocal-html/index.html-Fallback-Seite, damit dieses Feature sinnvoll ist. Details zum Offline-Fallback-Modus findest du unter Web-App einrichten.
Implementierungshinweise im SDK-Stil
Betrachte diese Funktion als native Fähigkeit, die deiner Web-Ebene bereitgestellt wird: Behalte deine Produktivwebsite oder PWA als zentrale Quelle bei und nutze anschließend die dokumentierten WebViewGold-Konfigurationsflags, URL-Befehle und JavaScript-Bridge-Aufrufe, um natives iOS-Verhalten nur dort zu aktivieren, wo es einen Mehrwert bietet. So bleibt deine Codebasis wartbar, da dieselbe Webanwendung mit minimaler Fallunterscheidung Browser, WebViewGold für iOS und die übrigen WebViewGold-Plattformen bedienen kann.
Für zuverlässige Ergebnisse empfehlen sich HTTPS-Endpunkte, stabile Routennamen, explizite Erfolgs-/Fehlerzustände in deiner UI sowie kleine JavaScript-Hilfsfunktionen, die native Aufrufe kapseln. Beispielsweise kann eine mit jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, einem eigenen React-/Vue-/Angular-Stack oder statischem HTML erstellte Web-App eine einzelne Schaltfläche oder einen Event-Handler bereitstellen, der die native WebViewGold-API auslöst und dennoch einen sauberen Browser-Fallback zeigt.
- Empfohlenes Integrationsmuster: Erkenne den App-Kontext, rufe die WebViewGold-API auf und aktualisiere anschließend deine Web-UI nach dem nativen Callback oder Routenwechsel.
- Test-Checkliste: Prüfe die Funktion auf einem echten Gerät oder in einem paketierten Build, überprüfe Berechtigungen und Store-Prüftexte und stelle sicher, dass reine Browser-Nutzer weiterhin einen sinnvollen Fallback erhalten.
- SEO-Vorteil: Halte Feature-Seiten, Routentitel und strukturierte Inhalte auf deiner Website indexierbar, während WebViewGold die native App-Hülle für iOS-Nutzer bereitstellt.