When do users get a live update?

By default, the app checks for updates when it comes to the foreground and every 10 minutes while it stays open. It downloads the new bundle in the background, installs it when the user leaves the app, and runs it the next time they open it. The autoUpdate setting changes this behavior.

Can devices pick up an urgent fix faster?

Yes. After you change a channel's bundle, send an update notification from the console, or add --send-update-notification to bundle upload. Devices get a silent push and check right away. This needs Capgo Notifications with iOS and Android push credentials. Delivery is best effort: an offline or force-quit app checks on its next launch.

What happens if an update breaks the app?

If a new bundle does not call notifyAppReady() within 10 seconds (the default appReadyTimeout), the device returns to the last working bundle and marks the new one as failed. For bugs that do not stop the app from starting, roll back the progressive rollout or pick an earlier bundle from the channel history.

How do we release to a few users first?

Upload with --rollout to send the bundle to a random, sticky share of the channel while everyone else stays on stable. Raise the percentage, promote, or roll back from the CLI or console. Auto-pause can stop exposure when the failure rate passes a threshold.

What can't a live update change?

Live updates replace the web layer: JavaScript, HTML, CSS, and assets. Native plugins, Capacitor upgrades, capacitor.config changes, and iOS or Android project files need a store release. Capgo checks bundles for native compatibility on upload, and channels can block updates to older binaries.

生产更新

让每个用户都能使用最新修复

从 CLI 或 CI 上上传一个新的 Web 包，设备在后台下载并在下一次应用回到前台时运行。通过百分比进行发布，使用 Observe 进行监控，如果它出现问题，则回滚。

来自马丁的人性化支持

开始免费试用与我们的团队联系

不需要信用卡

自动回滚

仅限 Web层更新

问题

生产环境更新的痛点

仅通过商店发布修复是一个缓慢的方式

传统的修复流程

找到问题

监控或支持报告显示屏幕已损坏。修复仅需几行JavaScript或CSS代码。

构建新二进制文件

您需要更新版本号，编译iOS和Android版本，并准备两个商店提交。

等待审核

商店审核通常需要24-48小时，有时甚至更长。被拒绝后，等待时间又开始了。

After approval, each user still has to install the new version. Until then, they run the old code.

经过批准后，每个用户仍需要安装新版本。直到那时，他们仍在运行旧版本__CAPGO_KEEP_0__。

为什么修复更新会慢慢到达用户

24–48小时+

商店更新的典型时间

苹果和谷歌会审查每个新二进制文件。审查通常需要24–48小时，有时更长，拒绝审查意味着需要重新提交。

每个用户

商店更新取决于每个设备

只有当用户或他们的自动更新设置安装更新时，商店更新才会到达设备。一些设备会长时间停留在旧版本中。

两家商店

每个修复需要两次提交

同一修复需要分别通过App Store和Google Play的审查和发布。

解决方案

如何让live update到达您的用户

这是Capgo的默认更新行为。无需更新提示、强制重启和提交web层更改。

Capgo默认更新流程

应用程序检查更新

当应用程序进入前台时，且在它保持打开状态时每10分钟，更新程序会向Capgo询问最新的频道包。

前台
它在后台下载

新包在用户继续使用当前版本时下载。使用delta更新时，只下载更改的文件。

无中断
它在下一次恢复时切换

当用户离开应用程序时，更新程序安装包。下一次打开时，他们将运行新版本。

下一次前台

需要用户在打开应用程序时立即看到新版本吗？直接更新模式在启动时应用它，splash屏幕显示时

查看最新更新

更新行为文档

如何工作

How production teams ship a fix with Capgo

一个已经上架的Capacitor应用的典型发布版本。以下所有命令来自CapgoCLI文档。

设置更新器一次

运行设置向导，然后确保您的应用程序调用notifyAppReady()后启动。一个从未做出该呼吁的捆绑包会回滚
```
npx @capgo/cli@latest init
# in your app start-up code
await CapacitorUpdater.notifyAppReady()
```
notifyAppReady()文档
上传修复到生产切片

使用--delta使设备只下载更改的文件，并使用--rollout以小比例开始。其他人仍在稳定捆绑包上
```
npx @capgo/cli@latest bundle upload --channel production --delta --rollout 5
```
渐进式发布文档
让Capgo停止坏的发布

设置失败率阈值（500基点是5%）自动暂停。如果失败率超过阈值，Capgo会回滚更新。请在观察中查看新版本。
```
npx @capgo/cli@latest channel set production \
  --auto-pause-enabled \
  --auto-pause-failure-rate-bps 500 \
  --auto-pause-action rollback
```
观察文档

推广到所有人

当数字看起来正确时，推广包到每台设备上。如果不正确，回滚更新分组到稳定版本。

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

回滚文档

为生产发布而设计

生产团队使用的控制生产发布的方式，通常不惊讧用户。

增量更新

使用 `--delta` 上传，设备只下载自上次更新以来变化的文件。较少变化的大资源只下载一次。

对于使用慢速或计量网络的用户，下载体积更小
在默认模式下，更新在会话之间应用，而不是在会话中间

增量更新文档

--delta

只下载变化的文件

渐进式发布，自动暂停

将一个随机、粘性共享的频道中的新包发送到稳定包的其他人，同时保持稳定包不变。提高百分比、推广或从CLI或控制台回滚。

自动暂停可以在失败率超过阈值时暂停或回滚一个发布
观察将新版本与之前的版本进行比较，然后才会提高曝光

渐进式发布文档

1–5%

发布流程的典型第一步

自动回滚

每个更新都必须证明它起作用。如果一个新包没有在时间内调用notifyAppReady()，设备就会返回到最后一个工作包，并将新包标记为失败

回滚触发器如果notifyAppReady()在appReadyTimeout（默认10秒）内没有被调用
将整个频道回滚到其历史中的任何较早的包

notifyAppReady()文档

10秒

自动回滚的默认appReadyTimeout

商店评论感知的交付

Capgo delivers the Capacitor web layer: JavaScript, CSS, and assets. It does not change the native binary, plugins, permissions, entitlements, or app-store metadata. Store review is app-specific, so you remain responsible for policy compliance and approval.