Vai al contenuto

@capgo/capacitor-webview-crash

Riavvia nativamente le WebView in crash e ricicla quelle di lunga durata a intervalli regolari

Riavvia nativamente le WebView in crash e ricicla quelle di lunga durata a intervalli regolari

Inizia con getPendingCrashInfo() e gli altri metodi principali elencati qui sotto.

PiattaformaSupportoNote
iOSSìNativo
AndroidSìNativo
WebParzialeVedi come iniziare
  • Riavvio dopo crash nativo - Riavvia la WebView su iOS o Android quando il processo di rendering termina.
  • Riavvio pianificato - Ricicla le WebView di lunga durata tramite un timer nativo usando restartIntervalMs o un orologio di sistema restartCron.
  • Riavvio nativo manuale - Permette a JavaScript di richiedere una nuova WebView nativa con restartWebView() senza ricaricare la pagina.
  • Configurazione Capacitor tipizzata - Espone WebViewCrashPluginConfig per plugins.WebViewCrash nella capacitor.config.ts.
  • getPendingCrashInfo - Restituisce il marker nativo di crash o riavvio memorizzato, oppure null quando non c'è nulla in sospeso.
  • clearPendingCrashInfo - Cancella il marker memorizzato dopo che l'app ha ripristinato il suo stato.
  • simulateCrashRecovery - Crea un marker di crash fittizio per poter testare i flussi di recupero in locale.
  • addListener - Emette webViewRestoredAfterCrash per i marker di crash e webViewRestoredAfterRestart per qualsiasi marker di riavvio nativo.
MetodoDescrizione
getPendingCrashInfoRestituisce il marker salvato di crash nativo o riavvio, oppure null quando non c'è nulla in sospeso.
clearPendingCrashInfoCancella il marker salvato dopo che l'app ha ripristinato il suo stato.
simulateCrashRecoveryCrea un marker di crash fittizio per testare i flussi di recovery localmente.
restartWebViewScrive reason: 'manualRestart' e chiede a code nativo di creare una nuova WebView.
addListenerEmette webViewRestoredAfterCrash oppure webViewRestoredAfterRestart quando un listener si collega e un marker corrispondente è ancora in sospeso.
removeAllListenersRimuove tutti i listener del plugin.

Il plugin estende Capacitor’s PluginsConfig con una voce di configurazione tipizzata WebViewCrash voce di configurazione:

export interface WebViewCrashPluginConfig {
restartOnCrash?: boolean;
restartIntervalMs?: number;
restartCron?: string;
restartAfterCrashDelayMs?: number;
}
  • Questo plugin rileva il recupero dopo un crash del WebView. Non previene il crash sottostante.
  • Il runtime JavaScript recuperato è nuovo, quindi qualsiasi stato in memoria del WebView precedente è già scomparso quando questo API viene attivato.
  • I riavvii pianificati scrivono reason: 'periodicRestart'; i riavvii manuali scrivono reason: 'manualRestart'. Salva lo stato non salvato prima di abilitare intervalli di riavvio brevi, pianificazioni cron o di chiamare restartWebView().
  • restartCron usa la sintassi cron a 5 campi nel fuso orario locale del dispositivo, ad esempio 0 3 * * * per un riavvio giornaliero alle 03:00. Non configurare entrambe le pianificazioni insieme: l'inizializzazione nativa genera un errore di configurazione fatale quando restartCron è impostato e restartIntervalMs è maggiore di 0.
  • Su Android, campi aggiuntivi come didCrash e rendererPriorityAtExit potrebbero essere disponibili.
  • Su iOS, il plugin registra appState quando viene rilevato il processo WebView terminato. I riavvii manuali e pianificati ricostruiscono la vista bridge Capacitor in modo che un nuovo WKWebView venga creato.

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-webview-crash.

Se stai usando @capgo/capacitor-webview-crash per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a Usare @capgo/capacitor-webview-crash per la funzionalità nativa in Using @capgo/capacitor-webview-crash, Uso di @capgo/capacitor-live-activities per la funzionalità nativa nella pagina Uso di @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per il dettaglio implementativo in @capgo/capacitor-live-activities, Uso di @capgo/capacitor-video-player per la funzionalità nativa nella pagina Uso di @capgo/capacitor-video-player, e @capgo/capacitor-video-player per il dettaglio implementativo in @capgo/capacitor-video-player.