Windy.com - 天气预报
天气应用:地图、警报和导航修复需要谨慎地扩展到生产环境。
- Google Play 安装量
- 32.9M
- 应用商店评分
- 4.7
通过 CLI 或 CI 上传新的 web bundle。设备会在后台下载,并在下次应用回到前台时运行。按百分比发布,在 Observe 中监控,出问题就回滚。
问题
定位 Bug
监控或客服报告某个界面出问题,修复只需几行 JavaScript 或 CSS。
构建新的二进制包
你需要升级版本号,分别为 iOS 和 Android 构建包,并准备两次商店提交。
等待审核
商店审核通常需要 24–48 小时,有时甚至更久。一旦被拒,等待又要重新开始。
等待用户更新
审核通过后,每个用户仍需安装新版本。在此之前,他们运行的仍是旧版 code。
每一个环节都会拉长从修复完成到修复在用户设备上生效的时间。
24–48 小时以上
应用商店典型审核时间
Apple 和 Google 会审核每个新的二进制包。审核通常需要 24–48 小时,有时更久,一旦被拒就得重新提交。
每位用户
商店更新取决于每台设备
只有当用户或自动更新设置完成安装后,商店更新才会到达设备。有些设备会长时间停留在旧 build 上。
2 个商店
每次修复都要提交两次
同一个 Web 修复需要分别通过 App Store 和 Google Play,且各自都有独立的审核和发布流程。
解决方案
这是 Capgo 的默认更新行为。没有更新提示,不会强制重启,Web 层变更也无需提交应用商店。
工作原理
已上架应用商店的 Capacitor 应用,一次典型的发布流程如下。下面所有命令都来自 Capgo CLI 文档。
运行 setup wizard,然后确保应用启动后调用 notifyAppReady()。从未调用该方法的 bundle 会自动回滚。
npx @capgo/cli@latest init
# in your app start-up code
await CapacitorUpdater.notifyAppReady() notifyAppReady() 文档 使用 --delta 让设备只拉取变更文件,用 --rollout 从一小部分设备开始灰度。其余设备继续使用稳定的 bundle。
npx @capgo/cli@latest bundle upload --channel production --delta --rollout 5 渐进式发布文档 开启自动暂停并设置失败率阈值(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 文档 当指标正常时,将 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
仅下载变更的文件
将新 bundle 发送给 channel 中随机且固定的一部分用户,其他人继续使用稳定版 bundle。你可以通过 CLI 或控制台提高比例、正式发布或回滚。
1–5%
典型的首次发布步骤
每次更新都必须证明自己能启动。如果新 bundle 未及时调用 notifyAppReady(),设备会回退到上一个可用的 bundle,并将新 bundle 标记为失败。
10s
自动回滚前的默认 appReadyTimeout
Capgo 负责交付 Capacitor 的 Web 层:JavaScript、CSS 和资源文件。它不会修改原生二进制文件、插件、权限、entitlements 或应用商店元数据。由于商店审核针对具体应用,您仍需对政策合规性和审批负责。
启用 Live Update 后的日常发布工作。每张卡片均链接至文档。
Capgo 自 2021 年起就一直在为生产 App 提供 Live Updates。
找到符合团队需求的解决方案
使用 Capacitor 构建的应用
天气、公共卫生和电信类应用依赖准确的界面、警报和导航。生产环境更新可帮助发布已审核的界面修复,同时监控采用情况,再决定是否扩大范围。
天气应用:地图、警报和导航修复需要谨慎地扩展到生产环境。
公共卫生应用:指南和服务信息需要快速、可信的更新。
电信账户应用,提醒和账户页面经常变动。
drivolino GmbH 首席开发者
“Capgo Capacitor Updater 插件彻底改变了我们的更新发布方式。过去需要几天的工作,现在只需几分钟。”
NuTriQ 创始人
“无需等待完整的 App Store 审核周期,就能即时推送生产环境的 OTA 更新,这为我们带来了巨大的运营优势。”
nethead emeritors
“这个 updater 插件做得太棒了。它在我这儿运行完美,live updates 对快速测试迭代是极大的加速。”
常见问题
更新如何到达设备,以及出问题时该怎么办。
默认情况下,App 会在进入前台时检查更新,并在保持打开期间每 10 分钟检查一次。它会在后台下载新的 bundle,在用户离开 App 时安装,并在下次打开时运行。autoUpdate 设置可更改此行为。
更新行为文档可以。更改 channel 的 bundle 后,从控制台发送更新通知,或在 bundle 上传时加上 --send-update-notification。设备会收到静默推送并立即检查。这需要 Capgo Notifications 以及 iOS 和 Android 推送凭据。推送送达不保证成功:离线或被强制退出的 App 会在下次启动时检查。
发送更新通知如果新的 bundle 在 10 秒内(默认 appReadyTimeout)没有调用 notifyAppReady(),设备会回退到上一个可用的 bundle,并将新 bundle 标记为失败。对于不影响 App 启动的 bug,请回滚渐进式发布,或从 channel 历史记录中选择更早的 bundle。
回滚文档使用 --rollout 上传,可将 bundle 推送给 channel 中随机且固定的一批用户,其他人仍留在 stable 版本。可在 CLI 或控制台提高百分比、全量发布或回滚。失败率超过阈值时,Auto-pause 会自动暂停发布,避免影响更多用户。
渐进式发布文档Live updates 替换的是 Web 层:JavaScript、HTML、CSS 和 assets。Native plugins、Capacitor 升级、capacitor.config 的更改以及 iOS 或 Android 项目文件都需要通过应用商店发布。Capgo 会在上传时检查 bundle 的原生兼容性,channel 也可以阻止旧版二进制文件获取更新。
Native 兼容性文档在试用期间,在自己的 App 上走一遍完整流程:上传一个 bundle,rollout 到几台设备,再回滚。