概述

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

注意

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

Public Asset Model

上传至Capgo的未加密包裹应被视为公共交付资产。通道决定了哪些设备将被提供更新，但通道的隐私并不使底层包裹保密。加密在存储和传输中提供保护，并防止第三方生成有效的加密更新，但它并不能使运输的Web资产无法被检查，因为应用程序包含用于解密的公共密钥。请参见 端到端加密 for the exact threat model.

Live Updates工作原理

Capgo的Live Update系统有两个关键组成部分:

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

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

当您将新JS包裹上传至Capgo并将其分配到通道时，Capgo的SDK将在配置为该通道的应用程序中检测到更新并下载它们。应用程序重启时，新的包裹将被加载。

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

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

开始使用

要开始使用实时更新，请遵循以下步骤：

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. 下载更新后，请关闭并重新打开您的应用程序以加载新包。

查看 实时更新部署 实时更新部署

实时更新部署

实时更新部署

实时更新部署

实时更新部署

实时更新部署

渐进式发布

将候选包发布到固定的群体中，监控它，然后推广或回滚。

回滚

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

更新行为

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

原生+OTA工作流

开发/生产通道 --fail-on-incompatible,以及如何在原生 code 有意改变时上传。

测试原生构建

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

快速更新

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

继续阅读概述

如果您正在使用 概述 与@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-in-app-review进行连接 有关@capgo/capacitor-in-app-review的实现细节 使用@capgo/capacitor-in-app-review 为使用@capgo/capacitor-in-app-review的原生能力 @capgo/capacitor-native-market 有关@capgo/capacitor-native-market的实现细节 for the implementation detail in @capgo/capacitor-native-market, 使用@capgo/capacitor原生市场 为原生能力在使用@capgo/capacitor原生市场, 和 Capacitor OTA更新：App Store审批指南 为实际上下文在Capacitor OTA更新：App Store审批指南.