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