メインコンテンツへスキップ

@capgo/capacitor-webview-crash

クラッシュした WebView をネイティブで再起動し、長時間実行中の WebView を一定間隔でリサイクルします

クラッシュした WebView をネイティブで再起動し、長時間実行中の WebView を一定間隔でリサイクルします

まずは getPendingCrashInfo() および以下に示すその他のコアメソッド。

プラットフォームサポート備考
iOSとはいネイティブ
Androidでははいネイティブ
Web一部はじめにを見る
  • ネイティブクラッシュ時の再起動 - レンダラープロセスが終了した際、iOS または Android から WebView を再起動します。
  • スケジュールされた再起動 - ネイティブタイマーを使用して、長時間実行中のWebViewをリサイクルします。 restartIntervalMs またはウォールクロック restartCron.
  • 手動ネイティブ再起動 - JavaScriptから新しいネイティブWebViewを次の方法で要求できます: restartWebView() ページをリロードせずに。
  • 型付き Capacitor 設定 - 公開 WebViewCrashPluginConfig を plugins.WebViewCrash における capacitor.config.ts.
  • getPendingCrashInfo - 保存されたネイティブクラッシュまたは再起動マーカーを返します。または null null を返します。
  • clearPendingCrashInfo - アプリが状態を復元した後に、保存されたマーカーをクリアします。
  • simulateCrashRecovery - 回復フローをローカルでテストできるように、偽のクラッシュマーカーを作成します。
  • addListener - 発火します webViewRestoredAfterCrash クラッシュマーカーに対して webViewRestoredAfterRestart ネイティブ再起動マーカーに対して
メソッド説明
getPendingCrashInfo保存されているネイティブのクラッシュまたは再起動マーカーを返します。保留中のものがない場合は null null を返します。
clearPendingCrashInfoアプリが状態を復元した後、保存されているマーカーをクリアします。
simulateCrashRecoveryリカバリフローをローカルでテストできるよう、擬似クラッシュマーカーを作成します。
restartWebView書き込みを行い、 reason: 'manualRestart' ネイティブの code に新しい WebView の作成をリクエストします。
addListener発火します。 webViewRestoredAfterCrash または webViewRestoredAfterRestart リスナーがアタッチされ、一致するマーカーがまだ保留中の場合。
removeAllListenersすべてのプラグインリスナーを削除します。

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

export interface WebViewCrashPluginConfig {
restartOnCrash?: boolean;
restartIntervalMs?: number;
restartCron?: string;
restartAfterCrashDelayMs?: number;
}
  • このプラグインは WebView クラッシュからの復旧を検出します。根本的なクラッシュを防止するものではありません。
  • 復旧した JavaScript ランタイムは新しいものなので、この API が発火した時点で、以前の WebView のメモリ内状態はすでに失われています。
  • スケジュールされた再起動は reason: 'periodicRestart'; 手動再起動は書き込みます reason: 'manualRestart'。短い再起動間隔、cron スケジュール、または呼び出しを有効にする前に、未保存の状態を永続化してください restartWebView().
  • restartCron はデバイスのローカルタイムゾーンで 5 フィールドの cron 構文を使用します。例: 0 3 * * * で毎日 03:00 に再起動します。両方のスケジュールを同時に設定しないでください。 restartCron が設定されており、 restartIntervalMs が 0.
  • より大きい場合、ネイティブ初期化時に致命的な設定エラーが発生します didCrash と rendererPriorityAtExit 。Android では、
  • などの追加フィールドが利用可能な場合があります。 appState 終了した WebView プロセスが検出された場合。手動およびスケジュールされた再起動では、Capacitor ブリッジビューが再構築され、新しい WKWebView が作成されます。

このリファレンスは以下から同期されています: src/definitions.ts における capacitor-webview-crash.

@capgo/capacitor-webview-crashから続ける

セクション「@capgo/capacitor-webview-crashから続ける」

使用している場合 @capgo/capacitor-webview-crash ネイティブメディアとインターフェースの挙動を計画するには、次と連携させてください @capgo/capacitor-webview-crash を使用 @capgo/capacitor-webview-crash を使う際のネイティブ機能については、 @capgo/capacitor-live-activities の使用 @capgo/capacitor-live-activities の使用におけるネイティブ機能については、 @capgo/capacitor-live-activities @capgo/capacitor-live-activities の実装の詳細については、 @capgo/capacitor-video-playerの使用方法 @capgo/capacitor-video-player を使用する際のネイティブ機能については、 @capgo/capacitor-video-player @capgo/capacitor-video-player. の実装の詳細については