Salta al contenuto principale
@capgo/capacitor-webview-crash Autenticazione e sicurezza Open source

Crash della WebView Plugin Capacitor

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

Installa

bun add @capgo/capacitor-webview-crash bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-webview-crash
  • pnpm add @capgo/capacitor-webview-crash
  • yarn add @capgo/capacitor-webview-crash

Guida

Come usare WebView Crash in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansiona il QR code.

QR di anteprima del plugin WebView Crash code

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 - Tipi plugins.WebViewCrash opzioni in 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.
  • 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

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.

FAQ

FAQ del plugin WebView Crash

Come installo il plugin WebView Crash in un'app Capacitor?

Esegui "bun add @capgo/capacitor-webview-crash" (oppure "npm install @capgo/capacitor-webview-crash"), poi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino il codice nativo code. Importalo da "@capgo/capacitor-webview-crash" nel tuo code dell'app.

Funziona @capgo/capacitor-webview-crash con React, Vue e Angular?

Sì. WebView Crash è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che gira all'interno di Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-webview-crash?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-webview-crash è gratuito e open source?

Sì. Il code sorgente è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-webview-crash/ e il pacchetto è gratuito da installare da npm. Bug report e pull request sono benvenuti.

Posso aggiornare code che usa WebView Crash senza una revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Rilascia le modifiche di WebView Crash senza aspettare la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo