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

概览

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

Live Updates 工作原理

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

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

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

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

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

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

标题为“为什么 Capgo Logs 至关重要（营销视角）”的章节
  • 对每次发布进行即时透视：单设备时间线会显示检查、下载、安装、策略拦截和回滚情况，让你确切掌握发生了什么——无需猜测，也不再有“我手机上运行正常”的争论。
  • 更快的故障响应: 类似告警的代码（例如速率限制、校验和失败、notifyAppReady 缺失）会在用户涌入支持渠道前显现，让你能在几分钟内发布修复或回滚。
  • 通道策略验证: 日志可验证防护措施（拦截主版本、禁用模拟器/开发构建、平台限制）是否正在积极保护生产环境。
  • 营收与声誉保护: 查看更新是否因网络环境差或达到套餐限制而停滞，以便在转化率、会话量或评分下降前及时介入。
  • 单一事实来源: 产品、QA 和支持团队共享同一云端日志流——无需翻找 Xcode/Android Studio 或私聊工程师获取原生日志。

快速入门

“快速入门”章节

要开始使用 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 Update 指南了解更多详情。

下一步

“后续步骤”章节

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

更新类型

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

渠道

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

渐进式发布

向固定用户群 (sticky cohort) 交付候选 bundle，进行监控，然后决定晋升或回滚。

回滚

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

更新行为

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

原生 + OTA 工作流

开发/生产渠道，搭配 --fail-on-incompatible以及有意更改原生 code 时如何上传。

测试 Native Builds

验证原生二进制文件，确保已下载的 live update 不会掩盖其打包的 Web 资源。

快速更新

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

从概览继续

章节标题：“从概览继续”

如果你正在使用 概览 以规划商店审核与分发，并将其与 @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 Updates：App Store 审核指南。