使用 @capgo/capacitor-webview-crash
检测 WebView 崩溃恢复情况,原生重启已崩溃的 WebView,并按固定间隔回收长时间运行的 WebView,避免内存压力最终导致 OOM。
安装
npm install @capgo/capacitor-webview-crash
npx cap sync
插件暴露的内容
- iOS 和 Android 上 WebView 崩溃后的原生重启。
- 针对连续运行数天的 kiosk、POS、数字标牌、扫码和 Dashboard 应用,提供固定间隔的原生 WebView 重启。
restartWebView- 让 JavaScript 可以请求全新的原生 WebView,而无需刷新页面。WebViewCrashPluginConfig- 类型plugins.WebViewCrash中的选项capacitor.config.ts.getPendingCrashInfo- 返回存储的原生崩溃或重启标记,或者null当没有待处理项时。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。在使用短间隔调度前,请务必持久化关键应用状态。
手动原生重启
调用 restartWebView() 当 JavaScript 决定主动替换原生 WebView 时,例如在执行完内存密集型工作流后:
await WebViewCrash.restartWebView();
该方法会写入 reason: 'manualRestart' 并要求原生 code 新建一个 WebView。Android 会重建宿主 Activity,iOS 会重建 Capacitor 桥接视图,从而让新的 WebView WKWebView 被创建,而不是重新加载当前页面。
完整参考
- 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.”中的原生能力