跳过主内容

更新器 Capacitor插件

立即将Ionic和Capacitor的实时更新部署到您的用户中,无需等待应用商店的审查延迟

安装

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

指南

如何在 Capacitor 中使用 Updater

在设备上测试

下载 Capgo 应用程序,然后扫描二维码 code

更新器插件预览二维码 code

Ionic 和 Capacitor 与 @capgo/capacitor-updater 的实时更新

@capgo/capacitor-updater is the open-source updater plugin behind Capgo live updates for Ionic and Capacitor apps. It downloads approved web bundles, applies them with native rollback protection, and keeps binary-only changes on the normal App Store and Play review path.

当您需要在原生壳已经批准后为 HTML、CSS、JavaScript、资产和其他 Web 层更改进行 OTA 更新时,请使用它。

安装

npm install @capgo/capacitor-updater
npx cap sync

适用场景

对于 Ionic 团队来说,实时更新通常意味着相同的工作流:不强制每个用户通过完整的商店发布。Capgo 为 Capacitor 应用程序处理该工作流,包括通道、兼容性检查、滚动控制、设备日志和回滚。

原生插件、特权、Android 清单更改、iOS plist 更改和二进制 SDK 更新仍然需要正常的应用商店发布。将这些更改保留在原生构建管道中,并使用实时更新来更新批准的 Web 层。

此插件暴露的内容

  • notifyAppReady - 通知原生层 JavaScript 已经初始化成功。
  • setUpdateUrl - 动态在运行时为应用设置更新 URL。
  • setStatsUrl - 动态在运行时为应用设置统计 URL。
  • setChannelUrl - 动态在运行时为应用设置渠道 URL。

- 示例用法

notifyAppReady

- 通知原生层 JavaScript 已经初始化成功。

import { CapacitorUpdater } from '@capgo/capacitor-updater';

const result = await CapacitorUpdater.notifyAppReady();
console.log(result);

setUpdateUrl

- 动态在运行时为应用设置更新 URL。

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setUpdateUrl({ url: 'https://example.com' });

setStatsUrl

- 动态在运行时为应用设置统计 URL。

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setStatsUrl({ url: 'https://example.com' });

setChannelUrl

- 动态在运行时为应用设置渠道 URL。

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setChannelUrl({ url: 'https://example.com' });

- 全部参考

继续从 @capgo/capacitor-updater

如果您正在使用 @capgo/capacitor-更新工具 为了计划实时更新,连接它与 实时更新 为产品工作流程 @capgo/capacitor-更新工具 查看实现细节 开始使用, 频道和 回滚.

常见问题

Updater 插件 FAQ

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

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

是否支持 @capgo/capacitor-updater 与 React、Vue 和 Angular 一起使用?

是的。Updater 是一个 Capacitor 包,因此它可以与任何在 Capacitor 内部运行的 web 框架一起使用,包括 Ionic、React、Vue、Angular、Svelte 和普通 JavaScript。

哪个 Capacitor 版本支持 @capgo/capacitor-updater?

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

是否支持 @capgo/capacitor-updater 免费和开源?

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

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

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

不必等待应用审核,直接将 Updater 的更改推送到商店

一旦插件在您的商店构建中,Capgo 直接更新将在几分钟内将 JavaScript、HTML 和 CSS 的更改推送给用户

开始使用 Capgo