@capgo/capacitor-webview-crash

長時間実行中のCapacitorアプリ用のネイティブ WebView のクラッシュ回復、手動再起動、および定期的な WebView のリサイクル

概要

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()長時間のセッション中、キオスク、POS、ダッシュボード、スキャナ、サインジアプリはメモリの蓄積を避けるのに役立ちます。

主な機能

ネイティブのクラッシュ再起動 - iOSまたはAndroidのウェブビューをレンダラーのプロセスが死んだときに再起動します。
定期的な再起動 - 長時間のウェブビューをネイティブのタイマーを使ってリサイクルします。 restartIntervalMs マニュアルのネイティブ再起動 - JavaScriptがページをリロードせずに新しいネイティブのウェブビューを要求することができます。 restartCron.
スケジュールされた再起動 - restartWebView() 定期的なウェブビューのリサイクル
Capacitor をタイプします - 公開 WebViewCrashPluginConfig の plugins.WebViewCrash で capacitor.config.ts.
getPendingCrashInfo - 保存されたネイティブのクラッシュまたは再起動マーカーを返します、または null 何も待っていない場合。
clearPendingCrashInfo - アプリが状態を復元した後、保存されたマーカーをクリアします。
simulateCrashRecovery - ローカルでリカバリフローをテストするために、偽のクラッシュマーカーを作成します。
addListener - クラッシュマーカーと webViewRestoredAfterCrash の webViewRestoredAfterRestart ネイティブの再起動マーカー

Public API

メソッド	説明
`getPendingCrashInfo`	native crash または再起動マーカーを返します。 `null` マーカーがなければ何も返されません。
`clearPendingCrashInfo`	マーカーをクリアします。
`simulateCrashRecovery`	アプリの状態を復元した後です。
`restartWebView`	テスト用にローカルで recovery フローのテストを実行するために、fake crash マーカーを作成します。 `reason: 'manualRestart'` native code に WebView を作成するように求めます。
`addListener`	native __CAPGO_KEEP_0__ に WebView を作成するように求めます。 `webViewRestoredAfterCrash` リスナーがマッチするマーカーがまだ pendding である場合に発火します。 `webViewRestoredAfterRestart` リスナーがマッチするマーカーがまだ pendding である場合に発火します。
`removeAllListeners`	プラグインリスナーをすべて削除します。

設定タイプ

Capacitorのプラグインは、型付きの設定エントリを追加します。 PluginsConfig 型付きの WebViewCrash 設定エントリ:

export interface WebViewCrashPluginConfig {
  restartOnCrash?: boolean;
  restartIntervalMs?: number;
  restartCron?: string;
  restartAfterCrashDelayMs?: number;
}

注記

このプラグインは、WebViewのクラッシュ後に回復を検出します。クラッシュを防ぐことはありません。
APIが発生すると、前のWebViewのインメモリ状態はすでに失われます。
スケジュールされた再起動は reason: 'periodicRestart';手動の再起動は reason: 'manualRestart'. 保存されていない状態を再起動間隔、cron スケジュール、または呼び出し前に保存する。 restartWebView().
restartCron デバイスのローカルタイムゾーンで使用する 5 つのフィールドの cron 語法の例 0 3 * * * 毎日 03:00 の再起動の場合です。 restartCron 両方のスケジュールを一度に設定しないでください: restartIntervalMs native の初期化は設定された場合と 0.
大きい場合に致命的な構成エラーを投げます。 didCrash Android の場合、追加のフィールドとして rendererPriorityAtExit と
が利用可能です。 appState when the terminated WebView process is observed. Manual and scheduled restarts rebuild the Capacitor bridge view so a new WKWebView を記録します。

マニュアルおよびスケジュールされた再起動は __CAPGO_KEEP_0__ ブリッジビューを再構築するため、新しい"が作成されます。

__CAPGO_KEEP_0__のリファレンスはsynced src/definitions.ts から capacitor-webview-crash.