Resumen
Sección titulada “Resumen”This plugin stores a native marker when the previous Capacitor WebView process dies or is recycled, then exposes that marker to the next JavaScript runtime after the app recovers. It can also restart the WebView from native code after a crash, on a fixed interval, on a cron schedule, or when JavaScript explicitly requests restartWebView()lo que ayuda a las aplicaciones de kiosk, POS, panel de control, escáner y señalización a evitar la acumulación de memoria durante sesiones largas.
Capacidades básicas
Título de la sección “Capacidades básicas”- Reiniciar accidente nativo - Reinicia el WebView desde iOS o Android cuando el proceso de renderizado muere.
- Reinicio programado - Recicla WebViews de larga duración en un temporizador nativo utilizando
restartIntervalMso un reloj de paredrestartCron. - Reinicio manual nativo - Permite a JavaScript solicitar un WebView nativo fresco con
restartWebView()sin realizar una recarga de página. - Configuración de tipo Capacitor - Exposición de
WebViewCrashPluginConfigparaplugins.WebViewCrashencapacitor.config.ts. getPendingCrashInfo- Devuelve el marcador de crash nativo almacenado o de reinicio, onull- Borra el marcador almacenado después de que tu aplicación haya restaurado su estado.clearPendingCrashInfo- Crea un marcador de crash falso para que los flujos de recuperación puedan ser probados localmente.simulateCrashRecovery- DisparaaddListener- para marcadores de crash ywebViewRestoredAfterCrash- para cualquier marcador de reinicio nativo.webViewRestoredAfterRestartPublic __CAPGO_KEEP_0__
Sección titulada “Public API”
Section titled “Public API”| Descripción | Devuelve el marcador de crash nativo almacenado o de reinicio, o |
|---|---|
getPendingCrashInfo | - Devuelve el marcador de crash nativo almacenado o de reinicio, o cuando no hay nada pendiente. null When no hay nada pendiente. |
clearPendingCrashInfo | Elimina el marcador almacenado después de que tu aplicación haya restaurado su estado. |
simulateCrashRecovery | Crear un marcador de falla falso para que los flujos de recuperación puedan ser probados localmente. |
restartWebView | Escritura reason: 'manualRestart' y pregunta a code nativo para crear una WebView fresca. |
addListener | Dispara webViewRestoredAfterCrash o webViewRestoredAfterRestart cuando un oyente se une y un marcador coincidente todavía está pendiente. |
removeAllListeners | Elimina todos los oyentes de plugin. |
Tipo de configuración
Sección titulada “Tipo de configuración”El plugin agrega una funcionalidad a Capacitor’s PluginsConfig con una entrada de configuración: WebViewCrash Copiar a portapapeles
export interface WebViewCrashPluginConfig { restartOnCrash?: boolean; restartIntervalMs?: number; restartCron?: string; restartAfterCrashDelayMs?: number;}Título de la sección “Observaciones”
Este plugin detecta la recuperación después de un crash de WebView. No previene el crash subyacente.- El entorno de tiempo de ejecución de JavaScript recuperado es nuevo, por lo que cualquier estado en memoria del WebView anterior ya ha desaparecido cuando se dispara este __CAPGO_KEEP_0__.
- The recovered JavaScript runtime is new, so any in-memory state from the previous WebView is already gone when this API fires.
- ; reinicios manuales escriben
reason: 'periodicRestart'. Guarda el estado no guardado antes de habilitar intervalos de reinicio cortos, horarios de cron o la llamada areason: 'manualRestart'utiliza la sintaxis de cron de 5 campos en la zona horaria local del dispositivo, por ejemplorestartWebView(). restartCronpara un reinicio diario a las 03:00. No configure ambos horarios al mismo tiempo: la inicialización nativa lanza un error de configuración fatal cuando0 3 * * *with a typedrestartCronestá configurado yrestartIntervalMses mayor que0.- En Android, campos adicionales como
didCrashyrendererPriorityAtExitpueden estar disponibles. - En iOS, el complemento registra
appStatecuando se observa el proceso de WebView terminado. Los reinicios manuales y programados reconstruyen la vista del puente Capacitor para crear un nuevoWKWebViewfuente de verdad
Título de la sección “Fuente de verdad”
Esta referencia se sincroniza desdeen src/definitions.ts Fuente de verdad Sigue adelante desde @capacitor/__CAPGO_KEEP_1__-webview-crash.
Sigue adelante desde @capgo/capacitor-webview-crash
Sección titulada “Sigue adelante desde @capgo/capacitor-webview-crash”Si estás utilizando @capgo/capacitor-webview-crash para planificar el comportamiento de medios y interfaz nativa, conecta con Usando @capgo/capacitor-webview-crash para la capacidad nativa en Usando @capgo/capacitor-webview-crash Usando @capgo/capacitor-live-activities para la capacidad nativa en Usando @capgo/capacitor-live-activities @capgo/capacitor-live-activities para el detalle de implementación en @capgo/capacitor-live-activities Usando @capgo/capacitor-reproductor-de-videos para la capacidad nativa en Usando @capgo/capacitor-reproductor-de-videos, y @capgo/capacitor-reproductor-de-videos para el detalle de implementación en @capgo/capacitor-reproductor-de-videos.