指南
如何在 Capacitor 中使用 WebView Version Checker
使用 @capgo/capacitor-webview-version-checker
用于检查 WebView 版本新旧并引导用户更新的 API 公共方案。
安装
bun add @capgo/capacitor-webview-version-checker
bunx cap sync
bunx cap sync 将插件的原生 code 复制到你的原生项目中。每次升级插件后都要重新运行。
导入
import { WebviewVersionChecker } from '@capgo/capacitor-webview-version-checker';
API 概览
| 方法 | 描述 |
|---|---|
check |
运行版本检查并返回最新的已知状态。 |
startMonitoring |
启用后台监控(通常在应用恢复时触发)。 |
stopMonitoring |
禁用监控。 |
getLastStatus |
返回上次解析的状态,或 null 如果尚未运行过检查。 |
showUpdatePrompt |
显示原生 prompt,提示用户更新 WebView。 |
openUpdatePage |
直接打开已配置的更新页面。 |
示例
check()
运行版本检查并返回最新的已知状态。
import { WebviewVersionChecker } from '@capgo/capacitor-webview-version-checker';
const result = await WebviewVersionChecker.check();
console.log(result);
startMonitoring()
启用后台监控(通常在应用恢复时触发)。
import { WebviewVersionChecker } from '@capgo/capacitor-webview-version-checker';
const result = await WebviewVersionChecker.startMonitoring();
console.log(result);
stopMonitoring()
禁用监控。
import { WebviewVersionChecker } from '@capgo/capacitor-webview-version-checker';
const result = await WebviewVersionChecker.stopMonitoring();
console.log(result);
getLastStatus()
返回上次解析的状态,或 null 如果尚未运行过检查。
import { WebviewVersionChecker } from '@capgo/capacitor-webview-version-checker';
const result = await WebviewVersionChecker.getLastStatus();
console.log(result);
showUpdatePrompt()
显示原生 prompt,提示用户更新 WebView。
import { WebviewVersionChecker } from '@capgo/capacitor-webview-version-checker';
const result = await WebviewVersionChecker.showUpdatePrompt();
console.log(result);
openUpdatePage()
直接打开已配置的更新页面。
import { WebviewVersionChecker } from '@capgo/capacitor-webview-version-checker';
const result = await WebviewVersionChecker.openUpdatePage();
console.log(result);
监听事件
addListener 会返回一个句柄。调用 handle.remove() 当屏幕卸载时。
完整参考文档
继续阅读 使用 @capgo/capacitor-webview-version-checker
如果你正在使用 使用 @capgo/capacitor-webview-version-checker 来规划原生媒体和界面行为,并将其与 @capgo/capacitor-webview-version-checker 了解 @capgo/capacitor-webview-version-checker 中的实现细节, 快速入门 有关“入门指南”中的实现细节, 使用 @capgo/capacitor-live-activities 用于使用 @capgo/capacitor-live-activities 时的原生能力, @capgo/capacitor-live-activities 关于 @capgo/capacitor-live-activities 中的实现细节,以及 使用 @capgo/capacitor-video-player 有关“使用 @capgo/capacitor-video-player.”中的原生能力