概述

使用 Capgo 的实时更新功能来远程更新您的应用程序的 JavaScript 代码包。直接将 JS 更新推送到 iOS、Android 和 Electron 等平台，无需通过商店级别的审查周期来修复 bug 和快速发布新功能。

注意

实时更新仅限于 JavaScript 代码包更改。如果您需要更新本机 code，例如添加或删除插件或更改本机项目配置，则需要通过通常的平台分发过程提交新的二进制构建。

公共资产模型

上传到 Capgo 的未加密代码包应被视为公共交付资产。通道决定了哪些设备可以接收更新，但通道的隐私并不使底层代码包保密。加密在存储和传输中提供保护，但它不会使已交付的 Web 资产无法被检查，因为应用程序包含用于解密的公钥。请参阅 端到端加密 ，以获取准确的威胁模型。

实时更新是如何工作的

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

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

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

当您将新 JS 包上传到 Capgo 并将其分配到一个频道时，Capgo SDK 在为该频道配置的应用中会检测到更新并下载它。下次应用重启时，新的包将被加载。

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

• 实时查看每次发布: 每个设备的时间线显示检查、下载、安装、策略阻止和回滚， 因此您知道发生了什么——没有猜测或“在我的手机上它工作”的争论。
• 快速事件响应: 在用户开始大量投诉之前，警告类代码（例如速率限制、校验和失败、notifyAppReady丢失）会在用户开始投诉之前显示，让您在几分钟内修复或回滚。
• 频道策略证明: 日志验证了保护生产环境的防护栏（阻止大型用户、禁用模拟器/开发版、平台限制）正在积极工作。
• 收入和声誉保护: 在网络差或达到计划限制时，更新会被暂停，您可以在转换、会话或评论下降之前介入。
• 单一真实来源: 产品、QA和支持团队共享同一个云日志流——不需要在Xcode/Android Studio中挖掘原生日志或与工程师发送信息。

开始使用

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

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

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

3. 在 Capgo: 构建您的 JS 包并上传

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

4. 打开应用程序并等待更新下载。您可以使用：

   npx @capgo/cli@latest app debug

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

查看 实时更新部署 指南详细说明。

下一步

更新类型

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

频道

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

回滚

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

更新行为

自定义更新如何和何时下载和应用在您的应用程序。

快速更新

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