跳转至正文
生产环境更新

让所有用户都用上最新修复

通过 CLI 或 CI 上传新的 web bundle。设备会在后台下载,并在下次应用回到前台时运行。按百分比发布,在 Observe 中监控,出问题就回滚。

无需信用卡
内置自动回滚
仅限 Web 层更新

问题

通过应用商店发布来修复小问题,效率实在太低

仅依赖应用商店的修复路径

1

定位 Bug

监控或客服报告某个界面出问题,修复只需几行 JavaScript 或 CSS。

2

构建新的二进制包

你需要升级版本号,分别为 iOS 和 Android 构建包,并准备两次商店提交。

3

等待审核

商店审核通常需要 24–48 小时,有时甚至更久。一旦被拒,等待又要重新开始。

4

等待用户更新

审核通过后,每个用户仍需安装新版本。在此之前,他们运行的仍是旧版 code。

每一个环节都会拉长从修复完成到修复在用户设备上生效的时间。

为什么商店修复触达用户这么慢

24–48 小时以上

应用商店典型审核时间

Apple 和 Google 会审核每个新的二进制包。审核通常需要 24–48 小时,有时更久,一旦被拒就得重新提交。

每位用户

商店更新取决于每台设备

只有当用户或自动更新设置完成安装后,商店更新才会到达设备。有些设备会长时间停留在旧 build 上。

2 个商店

每次修复都要提交两次

同一个 Web 修复需要分别通过 App Store 和 Google Play,且各自都有独立的审核和发布流程。

解决方案

live update 如何触达用户

这是 Capgo 的默认更新行为。没有更新提示,不会强制重启,Web 层变更也无需提交应用商店。

默认更新流程

  1. 应用检查更新

    应用进入前台时,以及保持打开期间每 10 分钟,更新器会向 Capgo 请求该通道的最新 bundle。

    进入前台时

  2. 后台下载

    用户继续使用当前版本时,新 bundle 会在后台下载。使用增量更新时,只下载有变更的文件。

    无中断

  3. 下次恢复时切换

    用户离开应用时,更新器会安装该 bundle。下次打开应用时,就会运行新版本。

    下次进入前台

需要用户一打开应用就看到新版本吗?直接更新模式会在启动画面显示期间应用更新。

查看直接更新

更新行为文档

工作原理

生产团队如何用 Capgo 发布修复

已上架应用商店的 Capacitor 应用,一次典型的发布流程如下。下面所有命令都来自 Capgo CLI 文档。

  1. 一次性配置 Updater

    运行 setup wizard,然后确保应用启动后调用 notifyAppReady()。从未调用该方法的 bundle 会自动回滚。

    npx @capgo/cli@latest init
    # in your app start-up code
    await CapacitorUpdater.notifyAppReady()
    notifyAppReady() 文档
  2. 将修复上传到一小部分生产环境

    使用 --delta 让设备只拉取变更文件,用 --rollout 从一小部分设备开始灰度。其余设备继续使用稳定的 bundle。

    npx @capgo/cli@latest bundle upload --channel production --delta --rollout 5
    渐进式发布文档
  3. 让 Capgo 拦下有问题的发布

    开启自动暂停并设置失败率阈值(500 个基点即 5%)。一旦失败率超过阈值,Capgo 就会回滚这次发布。发布期间可以在 Observe 中查看新版本。

    npx @capgo/cli@latest channel set production \
      --auto-pause-enabled \
      --auto-pause-failure-rate-bps 500 \
      --auto-pause-action rollback
    Observe 文档
  4. 向所有用户发布

    当指标正常时,将 bundle 发布到该 channel 下的所有设备。否则,将灰度批次回退到 stable。

    npx @capgo/cli@latest channel set production --rollout-promote
    # or, if something looks wrong
    npx @capgo/cli@latest channel set production --rollout-rollback
    回滚文档

专为生产环境发布打造

生产团队用来频繁发布、又不会让用户感到意外的控制手段。

增量更新

使用 --delta 上传,设备只下载自当前 bundle 以来发生变化的文件。很少变动的大型资源只需下载一次。

  • 为慢速或按流量计费网络上的用户减少下载量
  • 在默认模式下,更新会在会话之间应用,而不是在会话进行中应用。
Delta 更新文档

--delta

仅下载变更的文件

支持自动暂停的渐进式发布

将新 bundle 发送给 channel 中随机且固定的一部分用户,其他人继续使用稳定版 bundle。你可以通过 CLI 或控制台提高比例、正式发布或回滚。

  • 当失败率超过阈值时,Auto-pause 可暂停或回滚发布
  • 在放量前,Observe 会对比新版本与上一版本
渐进式发布文档

1–5%

典型的首次发布步骤

自动回滚

每次更新都必须证明自己能启动。如果新 bundle 未及时调用 notifyAppReady(),设备会回退到上一个可用的 bundle,并将新 bundle 标记为失败。

  • 如果未在 appReadyTimeout(默认 10 秒)内调用 notifyAppReady(),就会触发回滚
  • 从历史记录中把整个 channel 回滚到任意更早的 bundle
notifyAppReady() 文档

10s

自动回滚前的默认 appReadyTimeout

兼顾应用商店审核的交付

Capgo 负责交付 Capacitor 的 Web 层:JavaScript、CSS 和资源文件。它不会修改原生二进制文件、插件、权限、entitlements 或应用商店元数据。由于商店审核针对具体应用,您仍需对政策合规性和审批负责。

  • 当原生功能、插件、权限或应用商店元数据发生变更时,请使用原生商店发布
  • 在审核备注中清晰说明应用预期功能及 Web 层更新路径
  • 每次提交前,请查阅 Apple 和 Google 的最新政策

生产团队如何使用它

启用 Live Update 后的日常发布工作。每张卡片均链接至文档。

关键 Bug 修复

结账或登录界面出现错误时,可通过 Web 层修复。上传后,设备将在下次更新检查时获取修复。

更新行为文档

文案与内容变更

无需构建新的二进制文件,即可修正文案、更新帮助文本,或替换图片及其他 bundle 资源。

Native 兼容性文档

Observe 中的发布健康度

对比新旧 bundle:无故障率、启动与 WebView 耗时,以及各版本的部署标记。

Observe 文档

更新通知,加快更新采用

更改 channel 的 bundle 后,发送静默更新通知,让设备立即检查更新,而非等到下次进入前台。

发送更新通知

保护旧版原生构建

在 channel 上阻止主版本更新,确保需要新原生 code 的 bundle 永远不会推送到旧版二进制文件。

版本定向文档

从 Channel 历史记录回滚

在 Channel 的 History 标签页中选择任意较早的 bundle,即可让该 Channel 上的所有设备重新用上该版本。

回滚文档

已为生产 App 提供服务的基础设施

Capgo 自 2021 年起就一直在为生产 App 提供 Live Updates。

每月更新次数
10 亿+
覆盖设备数
9000万+
使用 Capgo 的 App
4700+
API 的典型延迟
~50ms

使用 Capacitor 构建的应用

高流量应用在生产环境中需要可靠的 UI 更新

天气、公共卫生和电信类应用依赖准确的界面、警报和导航。生产环境更新可帮助发布已审核的界面修复,同时监控采用情况,再决定是否扩大范围。

Windy.com - 天气预报应用图标 天气

Windy.com - 天气预报

天气应用:地图、警报和导航修复需要谨慎地扩展到生产环境。

Google Play 安装量
32.9M
应用商店评分
4.7
Conecte SUS 应用图标 医疗

连接 SUS

公共卫生应用:指南和服务信息需要快速、可信的更新。

Google Play 安装量
2770万
应用商店评分
4.6
Mi Orange 应用图标 工具

我的橙色

电信账户应用,提醒和账户页面经常变动。

Google Play 安装量
930 万
应用商店评分
4.2

客户证言

使用 Capgo 交付的团队怎么说

5.0/5 开发者团队评分 9,400+ 团队 查看评价
Sergiu S 的肖像

Sergiu S

drivolino GmbH 首席开发者

“Capgo Capacitor Updater 插件彻底改变了我们的更新发布方式。过去需要几天的工作,现在只需几分钟。”

Kapil

NuTriQ 创始人

“无需等待完整的 App Store 审核周期,就能即时推送生产环境的 OTA 更新,这为我们带来了巨大的运营优势。”

Michael Haberler 的肖像

Michael Haberler

nethead emeritors

“这个 updater 插件做得太棒了。它在我这儿运行完美,live updates 对快速测试迭代是极大的加速。”

常见问题

生产团队常问的问题

更新如何到达设备,以及出问题时该怎么办。

用户何时会收到 live update?

默认情况下,App 会在进入前台时检查更新,并在保持打开期间每 10 分钟检查一次。它会在后台下载新的 bundle,在用户离开 App 时安装,并在下次打开时运行。autoUpdate 设置可更改此行为。

更新行为文档

设备能否更快获取紧急修复?

可以。更改 channel 的 bundle 后,从控制台发送更新通知,或在 bundle 上传时加上 --send-update-notification。设备会收到静默推送并立即检查。这需要 Capgo Notifications 以及 iOS 和 Android 推送凭据。推送送达不保证成功:离线或被强制退出的 App 会在下次启动时检查。

发送更新通知

如果更新导致 App 无法正常运行怎么办?

如果新的 bundle 在 10 秒内(默认 appReadyTimeout)没有调用 notifyAppReady(),设备会回退到上一个可用的 bundle,并将新 bundle 标记为失败。对于不影响 App 启动的 bug,请回滚渐进式发布,或从 channel 历史记录中选择更早的 bundle。

回滚文档

如何先向少量用户发布?

使用 --rollout 上传,可将 bundle 推送给 channel 中随机且固定的一批用户,其他人仍留在 stable 版本。可在 CLI 或控制台提高百分比、全量发布或回滚。失败率超过阈值时,Auto-pause 会自动暂停发布,避免影响更多用户。

渐进式发布文档

live update 无法更改什么?

Live updates 替换的是 Web 层:JavaScript、HTML、CSS 和 assets。Native plugins、Capacitor 升级、capacitor.config 的更改以及 iOS 或 Android 项目文件都需要通过应用商店发布。Capgo 会在上传时检查 bundle 的原生兼容性,channel 也可以阻止旧版二进制文件获取更新。

Native 兼容性文档

将下一个修复作为 live update 发布

在试用期间,在自己的 App 上走一遍完整流程:上传一个 bundle,rollout 到几台设备,再回滚。