Utilisation de @capgo/capacitor-webview-crash

Détection de panne de WebView récupérée, redémarrage de WebViews morts nativement et recyclage de WebViews longs en cours sur un intervalle fixe avant que la pression de mémoire se transforme en OOM.

Installer

npm install @capgo/capacitor-webview-crash
npx cap sync

Ce que ce plugin expose

Redémarrage natif après panne de WebView sur iOS et Android.
Redémarrage natif de WebView sur un intervalle fixe pour les applications kiosk, POS, de signalisation, de scanner et de tableau de bord qui fonctionnent pendant des jours.
restartWebView - Permet à JavaScript de demander un WebView natif frais sans faire une mise à jour de page.
WebViewCrashPluginConfig - Types plugins.WebViewCrash options dans capacitor.config.ts.
getPendingCrashInfo - Retourne le marqueur de panne ou de redémarrage natif stocké, ou null lorsque rien n'est en attente.
clearPendingCrashInfo - Supprime le marqueur stocké après que votre application ait restauré son état.
simulateCrashRecovery - Crée un marqueur de crash fictif afin de tester les flux de récupération localement.
webViewRestoredAfterCrash - Événement de listener déclenché lorsque le marqueur de crash est toujours en attente dans le runtime récupéré.
webViewRestoredAfterRestart - Événement de listener déclenché lorsque tout marqueur de redémarrage natif est toujours en attente.

Exemple d'utilisation

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);
}

Redémarrage Auto-Natif

Configurez le comportement de redémarrage dans capacitor.config.ts afin qu'il continue à fonctionner lorsque JavaScript n'est pas disponible :

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;

Les redémarrages programmés écrivent reason: 'periodicRestart'. Utilisez restartIntervalMs pour des intervalles fixes ou restartCron pour un programme de tâches cron à 5 champs dans la zone horaire locale du dispositif, comme 0 3 * * * pour un redémarrage quotidien à 03:00. N'configurez pas les deux programmes à la fois : l'initialisation native lance une erreur de configuration mortelle lorsque restartCron est défini et restartIntervalMs est supérieur à 0Perservez l'état critique de l'application avant d'utiliser des programmes courts.

Redémarrage natif manuel

Appeler restartWebView() lorsque JavaScript décide que la vue WebView native doit être remplacée de manière proactive, par exemple après un workflow lourd en mémoire :

await WebViewCrash.restartWebView();

La méthode écrit reason: 'manualRestart' et demande à la native code de créer une vue WebView fraîche. Android reçoit une nouvelle activité hôte. iOS reçoit un nouveau pont de vue Capacitor pour charger une nouvelle WKWebView Référence complète

Appeler

GitHub: https://github.com/Cap-go/capacitor-webview-crash/
Docs : /docs/plugins/webview-crash/

Keep going from Using @capgo/capacitor-webview-crash

Si vous utilisez Using @capgo/capacitor-webview-crash pour planifier le comportement des médias et de l'interface native, connectez-le avec @capgo/capacitor-webview-crash for the implementation detail in @capgo/capacitor-webview-crash, Getting Started pour les détails d'implémentation dans Getting Started Using @capgo/capacitor-live-activities pour la capacité native dans Utiliser @capgo/capacitor-activités en direct, @capgo/capacitor-activités en direct pour le détail d'implémentation dans @capgo/capacitor-activités en direct, et Utiliser @capgo/capacitor-joueur de vidéo pour la capacité native dans Utiliser @capgo/capacitor-joueur de vidéo.

Panne de WebView

Tutoriel sur la panne de WebView