Usare @capgo/capacitor-webview-crash
Rileva i crash recuperati di WebView, riavvia nativamente le WebView inattive e ricicla le WebView attive a lungo a intervalli fissi prima che la pressione di memoria diventi un OOM.
Installa
npm install @capgo/capacitor-webview-crash
npx cap sync
Cosa espone questo plugin
- Riavvio nativo dopo i crash di WebView su iOS e Android.
- Riavvio nativo di WebView a intervalli fissi per app kiosk, POS, signage, scanner e dashboard che girano per giorni.
restartWebView- Consente a JavaScript di richiedere una nuova WebView nativa senza ricaricare la pagina.WebViewCrashPluginConfig- Tipiplugins.WebViewCrashopzioni incapacitor.config.ts.getPendingCrashInfo- Restituisce il marker nativo di crash o riavvio memorizzato, oppurenullquando 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.webViewRestoredAfterCrash- Evento listener emesso quando un marker di crash è ancora pendente nel runtime ripristinato.webViewRestoredAfterRestart- Evento listener emesso quando un marker nativo di riavvio è ancora pendente.
Esempio d'uso
import { WebViewCrash } from '@capgo/capacitor-webview-crash';
await WebViewCrash.addListener('webViewRestoredAfterCrash', async (info) => {
console.log('Recovered after a WebView crash', info);
await WebViewCrash.clearPendingCrashInfo();
});
await WebViewCrash.addListener('webViewRestoredAfterRestart', async (info) => {
console.log('Recovered after a native WebView restart', info);
await WebViewCrash.clearPendingCrashInfo();
});
const pending = await WebViewCrash.getPendingCrashInfo();
// Note: the listener callback may have already cleared the pending marker.
if (pending.value) {
console.log('Pending crash or restart marker', pending.value);
}
Riavvio automatico nativo
Configura il comportamento di riavvio in capacitor.config.ts in modo che continui a funzionare quando JavaScript non è disponibile:
import type { CapacitorConfig } from '@capacitor/cli';
import type { WebViewCrashPluginConfig } from '@capgo/capacitor-webview-crash';
const webViewCrash: WebViewCrashPluginConfig = {
restartOnCrash: true,
restartCron: '0 3 * * *',
restartAfterCrashDelayMs: 0,
};
const config: CapacitorConfig = {
plugins: {
WebViewCrash: webViewCrash,
},
};
export default config;
I riavvii pianificati scrivono reason: 'periodicRestart'. Usa restartIntervalMs per intervalli fissi o restartCron per una pianificazione cron a 5 campi nel fuso orario locale del dispositivo, come 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. Salva lo stato critico dell'app prima di usare pianificazioni brevi.
Riavvio nativo manuale
Chiama restartWebView() quando JavaScript decide di sostituire preventivamente la WebView nativa, ad esempio dopo un workflow ad alto consumo di memoria:
await WebViewCrash.restartWebView();
Il metodo scrive reason: 'manualRestart' e chiede a code nativo di creare una nuova WebView. Android ricrea l'activity host. iOS ricostruisce la Capacitor bridge view così una nuova WKWebView viene creata invece di ricaricare la pagina corrente.
Riferimento completo
- GitHub: https://github.com/Cap-go/capacitor-webview-crash/
- Documentazione: /docs/plugins/webview-crash/
Continua da Usare @capgo/capacitor-webview-crash
Se stai usando Usare @capgo/capacitor-webview-crash per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a @capgo/capacitor-webview-crash per i dettagli di implementazione in @capgo/capacitor-webview-crash, Per iniziare per i dettagli di implementazione nella guida introduttiva, Uso di @capgo/capacitor-live-activities per la funzionalità nativa nella pagina Uso di @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per i dettagli di implementazione in @capgo/capacitor-live-activities, e Uso di @capgo/capacitor-video-player per la funzionalità nativa in Usare @capgo/capacitor-video-player.