跳过主要内容

网页视图守卫 Capacitor插件

检测WebView在后台被杀死并在前台重新启动它

安装

bun add @capgo/capacitor-webview-guardian bunx cap sync
npm, pnpm 或 yarn
  • npm install @capgo/capacitor-webview-guardian
  • pnpm add @capgo/capacitor-webview-guardian
  • yarn add @capgo/capacitor-webview-guardian

指南

How to use WebView Guardian in Capacitor

在设备上测试

下载Capgo应用,扫描二维码code

WebView Guardian插件预览二维码code

使用@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()

Immediately forces a WebView health probe.

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

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

监听事件

addListener 返回一个句柄。调用 handle.remove() 全局参考

__CAPGO_KEEP_0__ 仓库

继续使用 @capgo/capacitor-webview-guardian

使用 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-webview-guardian 使用@capgo/capacitor-webview-guardian 为native媒体和界面行为规划,连接它 @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中

FAQ

常见问题

如何在Capacitor应用中安装WebView Guardian插件?

运行 "bun add @capgo/capacitor-webview-guardian" (或 "npm install @capgo/capacitor-webview-guardian"), 然后运行 "bunx cap sync" 以便 iOS 和 Android 项目能够接收到原生 code。从 "@capgo/capacitor-webview-guardian" 中导入它到您的应用程序 code 中。

@capgo/capacitor-webview-guardian 与 React、Vue 和 Angular 是否兼容?

是。WebView Guardian 是一个 Capacitor 包,因此它与任何在 Capacitor 内部运行的 web 框架兼容,包括 Ionic、React、Vue、Angular、Svelte 和普通 JavaScript。

@Capacitor 的哪个版本支持 @capgo/capacitor-webview-guardian?

@Capgo 插件遵循 Capacitor 的主要版本:使用与您的 Capacitor 主要版本匹配的插件主要版本(例如插件 v8 与 Capacitor 8)。在 GitHub README 中的兼容性表格列出了维护的版本。

@capgo/capacitor-webview-guardian 是否免费和开源?

是。源代码 code 公开在 GitHub 上,https://github.com/Cap-go/capacitor-webview-guardian/,并且该包可以从 npm 免费安装。欢迎 bug 报告和 pull 请求。

@code 使用 WebView Guardian 是否可以在不经过 App Store 审核的情况下更新?

安装或升级插件会更改原生 code,因此需要一个新的商店构建。之后,JavaScript、HTML 和 CSS 的更改可以立即通过 Capgo 实时更新发布。

无需等待应用程序审查即可将 WebView Guardian 的更改推送到生产环境

一旦插件在您的商店构建中,Capgo即刻将您的 JavaScript、HTML 和 CSS 更改推送给用户

开始使用 Capgo