概述

Use Capgo’s Live Updates feature to update the JavaScript bundles of your app remotely, in real-time. Push JS updates directly to your users on iOS, Android, and Electron without going through store-level review cycles to fix bugs and ship new features faster.

Note

Live Updates are limited to JavaScript bundle changes. If you need to update native code, such as adding or removing a plugin or changing native project configuration, you’ll need to submit a new binary build through the usual platform distribution process.

Public Asset Model

Unencrypted bundles uploaded to Capgo should be treated as public delivery assets. Channels determine which devices are offered an update, but channel privacy does not make the underlying bundle confidential. Encryption adds protection in storage and transit and stops third parties from producing valid encrypted updates, but it does not make shipped web assets impossible to inspect because the app contains the public key needed for decryption. See end-to-end 加密 针对具体的威胁模型。

如何实时更新工作

Capgo的实时更新系统有两个关键组件：

1. Capgo的SDK，您需要在应用程序中安装。SDK负责检查可用更新并在后台下载它们。

2. 频道，允许您针对特定用户组进行更新。您可以使用频道来管理不同发布轨迹，例如 Production, Staging和 Dev.

当您将新JS包上传到Capgo并将其分配到频道时，Capgo的SDK将检测到更新并下载它们。下一次应用程序重启时，将加载新包。

为什么Capgo日志很重要（营销视角）

• 实时X光机检查每次发布: 每个设备的时间线显示检查、下载、安装、策略阻止和回滚，知道发生了什么—没有猜测或“在我的手机上它工作”辩论。
• 更快的事件响应: 警报式代码（例如，速率限制、校验和失败、notifyAppReady misses）在用户开始涌入支持之前就浮现，让您在分钟内推送修复或回滚。
• 频道策略证明: 日志验证（阻止主要版本、禁用模拟器/开发版、平台限制）正在积极保护生产环境。
• 收入和声誉保护: 在更新在差网络上卡顿或达到计划限制时，看到可以介入之前转化、会话或评论下降。
• 单一真实来源: 产品、QA和支持共享相同的云日志流—不需要在Xcode/Android Studio中挖掘或与工程师通过DM发送原生日志。

开始使用

开始使用Live Updates，遵循以下步骤：

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

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

3. 构建您的 JS 包并将其上传到 Capgo:

   npm run build
   npx @capgo/cli@latest bundle upload --channel=production

4. 打开您的应用程序并等待更新下载。您可以使用以下命令检查状态：

   npx @capgo/cli@latest app debug

5. 下载更新后，关闭并重新打开您的应用程序以加载新包。

查看详细信息，请参见 部署实时更新 指南。

下一步

更新类型

OTA更新类型参考：应用时间、延迟条件、版本阻塞和交付。

频道

了解如何使用频道来管理不同发布轨迹并针对特定用户目标更新。

渐进式发布

将候选包分发给一小群用户，监控其进展，然后推广或回滚。

回滚

了解如何回滚到之前的JS包版本，如果更新引起问题。

更新行为

自定义更新下载和应用的方式和时间点。

测试原生构建

验证原生二进制文件，避免下载的实时更新遮盖其打包的Web资产。

快速更新

学习如何使用快速更新来加速更新过程。

继续从概述

如果您正在使用 概述 规划商店批准和分发，连接它 @capgo/capacitor-in-app-review 在capgo/capacitor中进行的应用内评论 使用capgo/capacitor-in-app-review 在capgo/capacitor-in-app-review中实现的原理 @capgo/capacitor-native-market 在capgo/capacitor中实现的原理 使用capgo/capacitor-native-market 在capgo/capacitor-native-market中实现的原理,以及 Capacitor OTA Updates: App Store Approval Guide 在Capacitor OTA Updates: App Store Approval Guide中实现的实践