WebView 安全防护 Capacitor 插件

使用 @capgo/capacitor-webview-guardian

Capacitor 插件用于检测 WebView 何时在后台被终止，并在回到前台时重新启动。

安装

bun add @capgo/capacitor-webview-guardian
bunx cap sync

bunx cap sync 将插件的原生 code 复制到你的原生项目中。每次升级插件后都要重新运行。

导入

import { WebviewGuardian } from '@capgo/capacitor-webview-guardian';

API 概览

方法	描述
startMonitoring	开始监听前台事件并自动检查 WebView 健康状态。
stopMonitoring	停止所有自动前台监控。
getState	返回当前已知的最新监控状态。
checkNow	立即强制触发一次 WebView 健康探测。

示例

startMonitoring()

开始监听前台事件并自动检查 WebView 健康状态。

import { WebviewGuardian } from '@capgo/capacitor-webview-guardian';

const result = await WebviewGuardian.startMonitoring();
console.log(result);

stopMonitoring()

停止所有自动前台监控。

import { WebviewGuardian } from '@capgo/capacitor-webview-guardian';

const result = await WebviewGuardian.stopMonitoring();
console.log(result);

getState()

返回当前已知的最新监控状态。

import { WebviewGuardian } from '@capgo/capacitor-webview-guardian';

const result = await WebviewGuardian.getState();
console.log(result);

checkNow()

立即强制触发一次 WebView 健康探测。

import { WebviewGuardian } from '@capgo/capacitor-webview-guardian';

const result = await WebviewGuardian.checkNow();
console.log(result);

监听事件

addListener 会返回一个句柄。调用 handle.remove() 当屏幕卸载时。

完整参考文档

• GitHub 仓库
• 文档
• API 参考文档

继续阅读“使用 @capgo/capacitor-webview-guardian”

如果你正在使用 使用 @capgo/capacitor-webview-guardian 来规划原生媒体和界面行为，并将其与 @capgo/capacitor-webview-guardian 了解 @capgo/capacitor-webview-guardian 中的实现细节， 快速入门 有关“入门指南”中的实现细节， 使用 @capgo/capacitor-live-activities 用于使用 @capgo/capacitor-live-activities 时的原生能力， @capgo/capacitor-live-activities 关于 @capgo/capacitor-live-activities 中的实现细节，以及 使用 @capgo/capacitor-video-player 有关“使用 @capgo/capacitor-video-player.”中的原生能力