Reinicia WebViews caídos de forma nativa y recicla WebViews de larga duración a intervalos fijos
Comienza con getPendingCrashInfo() y los demás métodos principales detallados abajo.
Soporte de plataformas
Sección titulada “Soporte de plataformas”| Plataforma | Soporte | Notas |
|---|---|---|
| iOS | Sí | Nativo |
| Android | Sí | Nativo |
| Web | Parcial | Ver primeros pasos |
Funcionalidades principales
Sección titulada “Funcionalidades principales”- Reinicio por crash nativo - Reinicia el WebView en iOS o Android cuando muere el proceso de renderizado.
- Reinicio programado - Recicla WebViews de larga duración con un temporizador nativo usando
restartIntervalMso un reloj de tiempo realrestartCron. - Reinicio nativo manual - Permite que JavaScript solicite un WebView nativo nuevo con
restartWebView()sin recargar la página. - Configuración tipada de Capacitor - Expone
WebViewCrashPluginConfigparaplugins.WebViewCrashencapacitor.config.ts. getPendingCrashInfo- Devuelve el marcador de crash o reinicio nativo almacenado, onullcuando no hay nada pendiente.clearPendingCrashInfo- Borra el marcador almacenado después de que tu app haya restaurado su estado.simulateCrashRecovery- Crea un marcador de crash falso para poder probar los flujos de recuperación localmente.addListener- DisparawebViewRestoredAfterCrashpara los marcadores de crash ywebViewRestoredAfterRestartpara cualquier marcador de reinicio nativo.
Público API
Sección titulada “Público API”| Método | Descripción |
|---|---|
getPendingCrashInfo | Devuelve el marcador almacenado de crash nativo o reinicio, o null cuando no hay nada pendiente. |
clearPendingCrashInfo | Borra el marcador almacenado después de que tu app haya restaurado su estado. |
simulateCrashRecovery | Crea un marcador de crash falso para probar los flujos de recuperación en local. |
restartWebView | Escribe reason: 'manualRestart' y pide al code nativo que cree un WebView nuevo. |
addListener | Se dispara webViewRestoredAfterCrash o webViewRestoredAfterRestart cuando se adjunta un listener y aún hay un marcador correspondiente pendiente. |
removeAllListeners | Elimina todos los listeners del plugin. |
Tipo de config
Sección titulada “Tipo de configuración”El plugin amplía la configuración de Capacitor PluginsConfig con una entrada de configuración tipada WebViewCrash entrada de configuración:
export interface WebViewCrashPluginConfig { restartOnCrash?: boolean; restartIntervalMs?: number; restartCron?: string; restartAfterCrashDelayMs?: number;}- Este plugin detecta la recuperación tras un crash de WebView. No previene el crash subyacente.
- El runtime de JavaScript recuperado es nuevo, por lo que cualquier estado en memoria del WebView anterior ya ha desaparecido cuando se dispara este API.
- Los reinicios programados funcionan
reason: 'periodicRestart'; los reinicios manuales escribenreason: 'manualRestart'. Persista el estado no guardado antes de habilitar intervalos de reinicio cortos, programaciones cron o de llamarrestartWebView(). restartCronusa la sintaxis cron de 5 campos en la zona horaria local del dispositivo, por ejemplo0 3 * * *para un reinicio diario a las 03:00. No configures ambos horarios a la vez: la inicialización nativa lanza un error de configuración fatal cuandorestartCronestá configurado yrestartIntervalMses mayor que0.- En Android, campos adicionales como
didCrashyrendererPriorityAtExitpueden estar disponibles. - En iOS, el plugin registra
appStatecuando se detecta el cierre del proceso WebView. Los reinicios manuales o programados reconstruyen la vista del bridge de Capacitor para que una nuevaWKWebViewse crea.
Fuente de verdad
Sección titulada “Fuente de verdad”Esta referencia se sincroniza desde src/definitions.ts en capacitor-webview-crash.
Continuar desde @capgo/capacitor-webview-crash
Sección titulada “Continuar desde @capgo/capacitor-webview-crash”Si estás usando @capgo/capacitor-webview-crash para planificar el comportamiento de los medios nativos y la interfaz, conéctalo con Usando @capgo/capacitor-webview-crash para la capacidad nativa en Usando @capgo/capacitor-webview-crash, Uso de @capgo/capacitor-live-activities para la capacidad nativa en Uso de @capgo/capacitor-live-activities, @capgo/capacitor-live-activities para los detalles de implementación en @capgo/capacitor-live-activities, Uso de @capgo/capacitor-video-player para la capacidad nativa en Uso de @capgo/capacitor-video-player, y @capgo/capacitor-video-player para el detalle de implementación en @capgo/capacitor-video-player.