@capgo/capacitor-webview-crash を使用
WebView のクラッシュ復旧を検出し、停止した WebView をネイティブに再起動。メモリプレッシャーが OOM になる前に、長時間稼働する WebView を一定間隔でリサイクルします。
インストール
npm install @capgo/capacitor-webview-crash
npx cap sync
このプラグインで利用可能な機能
- iOS/Android での WebView クラッシュ後のネイティブ再起動。
- 数日間稼働するキオスク、POS、サイネージ、スキャナー、ダッシュボードアプリ向けの、一定間隔でのネイティブ WebView 再起動。
restartWebView- ページのリロードなしで、JavaScript から新しいネイティブ WebView をリクエストできます。WebViewCrashPluginConfig- 型plugins.WebViewCrashのオプションcapacitor.config.ts.getPendingCrashInfo- 保存されたネイティブのクラッシュまたは再起動マーカーを返します。またはnullnull を返します。clearPendingCrashInfo- アプリが状態を復元した後に、保存されたマーカーをクリアします。simulateCrashRecovery- 回復フローをローカルでテストできるように、偽のクラッシュマーカーを作成します。webViewRestoredAfterCrash- 復元されたランタイムに未処理のクラッシュマーカーがある場合に発火するリスナーイベント。webViewRestoredAfterRestart- 未処理のネイティブ再起動マーカーがある場合に発火するリスナーイベント。
使用例
import { WebViewCrash } from '@capgo/capacitor-webview-crash';
await WebViewCrash.addListener('webViewRestoredAfterCrash', async (info) => {
console.log('Recovered after a WebView crash', info);
await WebViewCrash.clearPendingCrashInfo();
});
await WebViewCrash.addListener('webViewRestoredAfterRestart', async (info) => {
console.log('Recovered after a native WebView restart', info);
await WebViewCrash.clearPendingCrashInfo();
});
const pending = await WebViewCrash.getPendingCrashInfo();
// Note: the listener callback may have already cleared the pending marker.
if (pending.value) {
console.log('Pending crash or restart marker', pending.value);
}
Nativeの自動再起動
再起動の動作を以下で設定します capacitor.config.ts JavaScript が利用できない場合でも動作を維持できるようにします:
import type { CapacitorConfig } from '@capacitor/cli';
import type { WebViewCrashPluginConfig } from '@capgo/capacitor-webview-crash';
const webViewCrash: WebViewCrashPluginConfig = {
restartOnCrash: true,
restartCron: '0 3 * * *',
restartAfterCrashDelayMs: 0,
};
const config: CapacitorConfig = {
plugins: {
WebViewCrash: webViewCrash,
},
};
export default config;
スケジュール再起動の書き込み reason: 'periodicRestart'. 入力が不正な場合は、 restartIntervalMs 固定間隔の場合 restartCron または、デバイスのローカルタイムゾーンで5フィールドのcronスケジュールの場合、例えば 0 3 * * * 毎日03:00に再起動する場合。両方のスケジュールを同時に設定しないでください: restartCron が設定されており、 restartIntervalMs が 0より大きい場合、ネイティブ初期化時に致命的な設定エラーが発生します。短いスケジュールを使用する前に、重要なアプリ状態を永続化してください。
Nativeの手動再起動
呼び出す restartWebView() JavaScriptがネイティブWebViewを能動的に置き換えるべきと判断した場合、例えばメモリ負荷の高いワークフローの後:
await WebViewCrash.restartWebView();
このメソッドは書き込みます reason: 'manualRestart' ネイティブの code に新しい WebView の作成を要求します。Android ではホストアクティビティが再作成され、iOS では Capacitor ブリッジビューが再構築されて新しい WKWebView WebViewが作成されるようにします。
リファレンス全文
- GitHub: https://github.com/Cap-go/capacitor-webview-crash/
- ドキュメント: /docs/plugins/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. の使い方」のネイティブ機能については