跳转到正文
Capgo - 构建、发布并更新 Capacitor 应用 Capgo

概览

使用 Capgo 的 Live Updates 功能，实时远程更新应用的 JavaScript bundle。无需经过应用商店的审核周期，即可直接向 iOS、Android 和 Electron 用户推送 JS 更新，从而更快地修复 Bug 并发布新功能。产品概览和常见问题请参阅 Capacitor Live Updates capgo.app。

Live Updates 工作原理

标题为“Live Update 工作原理”的章节

Capgo 的 Live Update 系统包含两个核心组件：

  1. 你安装在应用中的 Capgo SDK。SDK 会在后台检查可用更新并下载。

  2. Channels 让你可以针对特定用户群推送更新。你可以用 channels 管理不同的发布轨道，例如： Production, Staging，以及 Dev.

当你向 Capgo 上传新的 JS bundle 并将其分配给某个 channel 时，针对该 channel 配置的应用中的 Capgo SDK 会检测到更新并下载。应用下次重启时，将加载新的 bundle。

为什么 Capgo Logs 至关重要（营销视角）

标题为“为什么 Capgo Logs 至关重要（营销视角）”的章节
  • 实时洞察每一次发布详情: 每个设备的 Timeline 会显示检查、下载、安装、策略拦截和回滚记录，让你精准掌握发生的一切——告别“我手机上没问题”这种毫无意义的争论。
  • 更快的故障响应速度: 类似告警的代码（例如速率限制、校验和失败、notifyAppReady 缺失）会在用户涌入客服之前显现，让你能在几分钟内发布修复或执行回滚。
  • Channel 策略验证: 日志可验证各项防护措施（拦截大版本、禁用模拟器/开发版、平台限制）是否正在积极保护生产环境。
  • 保护营收与声誉: 查看更新是否因网络环境差或达到套餐限制而停滞，以便在转化率、会话数或评分下降前及时介入。
  • 单一事实来源: 产品、QA 和 Support 共享同一套云端日志流——无需在 Xcode/Android Studio 中翻找，也不用私聊工程师索要 Native 日志。

快速入门

标题为“快速入门”的章节

要开始使用 Live Updates，请按以下步骤操作：

  1. 完成 Capgo 快速入门 在 Capgo 中设置你的应用并安装 Capgo SDK。

  2. 在应用 code 中，调用 CapacitorUpdater.notifyAppReady() 在应用初始化完成后。这会告知 Capgo SDK 你的应用已准备好接收更新。

  3. 构建你的 JS bundle 并上传到 Capgo：

    终端窗口
    npm run build
    npx @capgo/cli@latest bundle upload --channel=production

  4. 打开应用并等待更新下载。你可以用以下方式查看状态：

    终端窗口
    npx @capgo/cli@latest app debug

  5. 更新下载完成后，关闭并重新打开应用以加载新的 bundle。

请参阅 部署 Live Updates 指南了解更多详情。

下一步

“后续步骤”章节

若要为更新请求使用自定义主机名，请参考 自定义域名设置指南.

更新类型

所有 OTA 更新类型参考：包含应用时机、延迟条件、版本限制及交付方式。

通道

学习如何使用 channels 管理不同的发布轨道，并将更新定向推送给特定用户。

渐进式发布

将候选 bundle 推送至特定用户群进行监控，随后决定发布或回滚。

回滚

了解当更新引发问题时，如何回滚到之前的 JS bundle 版本。

更新行为

自定义应用内更新的下载与应用方式及时机。

Native + OTA 工作流

开发/生产环境渠道，以及 --fail-on-incompatible，以及在有意更改 native code 时如何进行 upload。

测试 Native Builds

在没有下载 live update 遮盖 bundle web 资源的情况下验证 native binary。

快速更新

了解如何使用快速更新来加速更新流程。

从概览继续

标题为“从概览继续”的章节

如果你正在使用 概览 要规划商店审核与分发，请将其与 @capgo/capacitor-in-app-review 有关 @capgo/capacitor-in-app-review 中的实现细节， 使用 @capgo/capacitor-in-app-review 有关《使用 @capgo/capacitor-in-app-review》中的原生能力， @capgo/capacitor-native-market 有关 @capgo/capacitor-native-market 中的实现细节， 使用 @capgo/capacitor-native-market 有关《使用 @capgo/capacitor-native-market》中的原生能力，以及 Capacitor OTA 更新：App Store 审核指南 有关 Capacitor OTA 更新：App Store 审核指南的实际背景。