跳转至正文
@capgo/capacitor-webview-version-checker 身份验证与安全 开源

WebView 版本检查器 Capacitor 插件

Capacitor 插件,用于检查 Android WebView 版本是否为最新,并引导用户进入原生更新流程

安装

bun add @capgo/capacitor-webview-version-checker bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-webview-version-checker
  • pnpm add @capgo/capacitor-webview-version-checker
  • yarn add @capgo/capacitor-webview-version-checker

指南

如何在 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.”中的原生能力

常见问题

WebView Version Checker 插件常见问题

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

运行 "bun add @capgo/capacitor-webview-version-checker"(或 "npm install @capgo/capacitor-webview-version-checker"),然后运行 "bunx cap sync",使 iOS 和 Android 项目同步原生 code。最后在你的应用 code 中从 "@capgo/capacitor-webview-version-checker" 导入即可。

@capgo/capacitor-webview-version-checker 是否支持 React、Vue 和 Angular?

支持。WebView Version Checker 是一个 Capacitor 包,因此它支持任何在 Capacitor 中运行的 Web 框架,包括 Ionic、React、Vue、Angular、Svelte 以及原生 JavaScript。

@capgo/capacitor-webview-version-checker 支持哪个 Capacitor 版本?

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-webview-version-checker 是免费开源的吗?

是的。code 的源码已在 GitHub 公开,地址为 https://github.com/Cap-go/capacitor-webview-version-checker/,并且你可以直接从 npm 免费安装该 package。欢迎提交 Bug 报告或 Pull Request。

我能否在无需经过 App Store 审核的情况下,更新使用了 WebView Version Checker 的 code?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待应用审核即可上线 WebView Version Checker 的变更

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo