@capgo/capacitor-webview-crash

Übersicht

Diese Erweiterung speichert einen nativen Marker, wenn das vorherige Capacitor WebView-Prozess stirbt oder recycelt wird, und stellt dann diesen Marker der nächsten JavaScript-Ausführung nach der Wiederherstellung der App zur Verfügung. Sie kann auch den WebView von der nativen code nach einem Crash, auf einem festen Intervall, auf einem Cron-Schema oder wenn JavaScript explizit anfordert restartWebView(), was Kiosk-, POS-, Dashboard-, Scanner- und Signage-Anwendungen dabei hilft, während langen Sitzungen Speicherabfall zu vermeiden.

Kernfunktionen

• Natives Crash-Neustart - Neustart der WebView von iOS oder Android, wenn der Renderer-Prozess abstürzt.
• Geplantes Neustart - Recycelt lange laufende WebViews auf einem nativen Timer mit restartIntervalMs oder einem Uhrzeigerschalter restartCron.
• Manueller natives Neustart - Lässt JavaScript einen frischen nativen WebView anfordern, restartWebView() ohne eine Seite neu zu laden.
• Typierte Capacitor-Konfiguration - Exponiert WebViewCrashPluginConfig für plugins.WebViewCrash in capacitor.config.ts.
• getPendingCrashInfo – Gibt den gespeicherten nativen Crash- oder Neustartmarker zurück, oder null wenn nichts ansteht.
• clearPendingCrashInfo – Löschet den gespeicherten Marker nachdem Ihre App ihren Zustand wiederhergestellt hat.
• simulateCrashRecovery - Erstellt einen fiktiven Crashmarker, um lokale Recovery-Flows zu testen.
• addListener - Auslöst webViewRestoredAfterCrash - für Crashmarker und webViewRestoredAfterRestart - für jeden native Restartmarker.

Öffentliche API

Methode	Beschreibung
getPendingCrashInfo	Gibt das gespeicherte native Crash- oder Restartmarker zurück, oder null wenn nichts ansteht.
clearPendingCrashInfo	Löscht den gespeicherten Marker nachdem Ihre App ihren Zustand wiederhergestellt hat.
simulateCrashRecovery	Erstellt einen fiktiven Crashmarker, um lokale Recovery-Flows zu testen.
restartWebView	Schreibt reason: 'manualRestart' und fragt native code nach, ein frisches WebView zu erstellen.
addListener	Auslöst webViewRestoredAfterCrash oder webViewRestoredAfterRestart wenn ein Listener anhängt und ein passender Marker noch ausstehend ist.
removeAllListeners	Entfernt alle Plugin-Listener.

Konfigurationstyp

Der Plugin erweitert Capacitor’s PluginsConfig mit einem WebViewCrash typisierten

export interface WebViewCrashPluginConfig {
  restartOnCrash?: boolean;
  restartIntervalMs?: number;
  restartCron?: string;
  restartAfterCrashDelayMs?: number;
}

Hinweise

• Dieses Plugin erkennt eine Wiederherstellung nach einem WebView-Crash. Es verhindert jedoch keinen zugrunde liegenden Crash.
• Die wiederhergestellte JavaScript-Umgebung ist neu, daher ist der gesamte in-Memory-Zustand vom vorherigen WebView bereits verschwunden, wenn dieser API ausgelöst wird.
• Geplante Neustarts schreiben reason: 'periodicRestart'; manuelle Neustarts schreiben reason: 'manualRestart'. Speichern Sie ungelesene Daten, bevor Sie kurze Neustartschritte, Cron-Aufträge oder Aufrufe restartWebView().
• restartCron verwenden, die 5-Felder-Cron-Syntax in der Gerätezeitzone verwenden, zum Beispiel 0 3 * * * für einen täglichen Neustart um 03:00 Uhr. Konfigurieren Sie nicht beide Schedules gleichzeitig: Die native Initialisierung wirft einen fatalen Konfigurationsfehler, wenn restartCron festgelegt ist und restartIntervalMs größer als 0.
• Bei Android-Geräten werden zusätzliche Felder wie didCrash und rendererPriorityAtExit möglicherweise verfügbar.
• Bei iOS wird der Plugin die appState beobachtet, wenn der beendete WebView-Prozess ist. Manuelle und geplante Neustarts bauen die Capacitor-Brückensicht so um, dass eine neue WKWebView Quelle der Wahrheit

Sektion mit dem Titel “Quelle der Wahrheit”

im src/definitions.ts __CAPGO_KEEP_0__-webview-crash Fortsetzen von @capacitor/__CAPGO_KEEP_1__-webview-crash.

Sektion mit dem Titel “Fortsetzen von @capgo/capacitor-webview-crash”

Wenn Sie diese Funktion verwenden @capgo/capacitor-webview-crash um native Medien und Schnittstellenverhalten zu planen und zu verbinden Verwenden Sie @capgo/capacitor-webview-crash für die native Fähigkeit in Verwendung von @capgo/capacitor-webview-crash Verwenden Sie @capgo/capacitor-live-activities für die native Fähigkeit in Verwendung von @capgo/capacitor-live-activities @capgo/capacitor-live-activities für die Implementierungsdetails in @capgo/capacitor-live-activities Verwenden Sie @capgo/capacitor-video-player für die native Fähigkeit in Verwendung von @capgo/capacitor-video-player und @capgo/capacitor-video-player {"targetLanguage":"German","pagePath":"/de/docs/plugins/webview-crash/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"für die Implementierungsdetails in @capgo/capacitor-Video-Player."},{"text":"Seite bearbeiten"}]}