跳过主要内容

插件 Cordova iOS 和 Android 的 OTA 实时更新

Cordova iOS 和 Android 的 OTA 直接更新,使用相同的 API 和 capacitor-updater

复制安装命令

bun add @capgo/cordova-updater
npm, pnpm 或 yarn
  • npm install @capgo/cordova-updater
  • pnpm add @capgo/cordova-updater
  • yarn add @capgo/cordova-updater

与插件团队联系

使用指南

使用 @capgo/cordova-updater

@capgo/cordova-updater 将 Capgo 的实时更新带给 Cordova iOS 和 Android 应用,使用相同的 JavaScript API @capgo/capacitor-updater。安装 Cordova 插件,调用 notifyAppReady() 在每次启动时调用,并上传 @capgo/cli.

安装

cordova plugin add @capgo/cordova-updater --variable APP_ID=com.example.app
cordova prepare android ios

基本使用

document.addEventListener('deviceready', async () => {
  const { Updater } = cordova.plugins;

  await Updater.notifyAppReady();

  const { bundle } = await Updater.current();
  console.log('Active bundle', bundle);

  const latest = await Updater.getLatest();
  if (latest.url && !latest.error) {
    const downloaded = await Updater.download({
      url: latest.url,
      version: latest.version,
      checksum: latest.checksum,
    });

    await Updater.next({ id: downloaded.id });
  }
});

平台要求

  • Cordova Android 13+ 和 Cordova iOS 7+
  • 默认 Cordova WebView 方案(https://localhost/ 在 Android 上, app://localhost/ 在 iOS 上)
  • 避免 cordova-plugin-ionic-webview ——它防止捆绑包交换

部署一个新捆绑包

bun run build
bunx @capgo/cli@latest bundle upload --channel=production

实用建议

  • 如果您还部署了Capgo或Electron客户端,请重用相同的Capacitor应用ID和频道
  • 对原生插件或Cordova平台升级一样处理:在JavaScript捆绑包中使用新原生API之前,先将新商店二进制文件部署
  • 完整的设置详细信息在 Cordova更新器文档.

常见问题

Cordova Updater插件常见问题

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

运行"bun add @capgo/cordova-updater" (或 "npm install @capgo/cordova-updater" ),然后遵循指南中的Cordova设置步骤和GitHub README。

是否@capgo/cordova-updater与React、Vue和Angular兼容?

是。Cordova Updater是一个Cordova包,因此它与任何运行在Cordova内的Web框架,包括React、Vue、Angular、Svelte和普通JavaScript,兼容。

是否@capgo/cordova-updater免费且开源?

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

不必等待应用审核即可将 Cordova Updater 变更推送

在您的商店构建中安装插件后,Capgo即刻更新将您的JavaScript、HTML和CSS更改推送给用户。

开始使用Capgo