Reconnect API
Reload the last online URL from your offline / fallback HTML page — the perfect "Try again" button for your custom offline screen.
Die Reconnect-API lädt die letzte Online-URL erneut, auf der sich der Nutzer befand, bevor die App auf die Offline-HTML-Seite ausgewichen ist. Ideal als „Erneut versuchen"-Button auf Ihrer eigenen Fallback-Seite.
So verwenden Sie die Funktion:
Bauen Sie den Trigger in Ihre Offline-Seite ein (typischerweise local-html/index.html):
<button onclick="window.location.href='reconnect://'">Try to reconnect</button>
Wie es funktioniert:
Die App merkt sich die letzte erfolgreich geladene Nicht-Helper-URL. Wenn der Nutzer reconnect:// auslöst, navigiert der WebView zurück zu dieser URL. Ist die Verbindung noch immer weg, erscheint wieder Ihre Fallback-Seite.
Zugehörige Config:
FALLBACK_USE_LOCAL_HTML_FOLDER_IF_OFFLINEin Config.java musstruesein, und Sie brauchen einelocal-html/index.html-Fallback-Seite, damit diese Funktion sinnvoll wirkt.
Implementierungshinweise im SDK-Stil
Betrachten Sie diese Funktion als native Fähigkeit, die Ihrer Web-Ebene bereitgestellt wird: Behalten Sie Ihre Produktivwebsite oder PWA als zentrale Quelle bei und nutzen Sie anschließend die dokumentierten WebViewGold-Konfigurationsflags, URL-Befehle und JavaScript-Bridge-Aufrufe, um natives Android-Verhalten nur dort zu aktivieren, wo es einen Mehrwert bietet. So bleibt Ihre Codebasis wartbar, da dieselbe Webanwendung mit minimaler Fallunterscheidung Browser, WebViewGold für Android und die übrigen WebViewGold-Plattformen bedienen kann.
Für zuverlässige Ergebnisse empfehlen sich HTTPS-Endpunkte, stabile Routennamen, explizite Erfolgs-/Fehlerzustände in Ihrer 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: Erkennen Sie den App-Kontext, rufen Sie die WebViewGold-API auf und aktualisieren Sie anschließend Ihre Web-UI nach dem nativen Callback oder Routenwechsel.
- Test-Checkliste: Prüfen Sie die Funktion auf einem echten Gerät oder in einem paketierten Build, überprüfen Sie Berechtigungen und Store-Prüftexte und stellen Sie sicher, dass reine Browser-Nutzer weiterhin einen sinnvollen Fallback erhalten.
- SEO-Vorteil: Halten Sie Feature-Seiten, Routentitel und strukturierte Inhalte auf Ihrer Website indexierbar, während WebViewGold die native App-Hülle für Android-Nutzer bereitstellt.