概述

使用 Capgo 的实时更新功能来远程实时更新您的应用的 JavaScript 包。直接将 JS 更新推送给您的用户，而无需通过应用商店审查流程来立即修复 bug 和发布新功能。

注意

Live Updates仅限于JavaScript打包变化。如果您需要更新本机code,例如添加或删除插件或更改本机项目配置，则需要将新的本机二进制文件提交到应用商店。

Live Updates工作原理

Capgo的Live Update系统有两个关键组件：

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

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

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

入门

要开始使用实时更新，请按照以下步骤进行：

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

查看 Deploying Live Updates guide for more details.

Capgo CLI

Capgo CLI 是一个强大的工具，允许开发人员从自己的 CI/CD pipelines 与 Capgo 的服务进行交互。通过 CLI，您可以对生成和部署的时间有细粒度的控制，从而使您能够将 Capgo 集成到现有的企业工作流中。

Capgo CLI 是什么？

Capgo CLI 是为需要在实时更新工作流中拥有更多控制和灵活性的开发人员和团队而设计的。通过在 CI/CD pipelines 中使用 CLI，您可以：

• 决定何时生成和部署更新，而不是依赖 Capgo 的内置自动化
• 在生成和部署步骤之间插入自己的过程，例如 code 签名、QA 测试或经理批准
• 将Capgo整合到您的现有DevOps工具和工作流程中

身份验证

要使用Capgo CLI，您需要使用API密钥进行身份验证。您可以在Capgo帐户设置中生成API密钥。

要登录并安全存储API密钥，请运行：

npx @capgo/cli@latest login [API_KEY]

此命令将在将来被保存。您不需要在登录后为每个命令提供API密钥。

与其他CLI工具的主要区别

如果您熟悉其他实时更新CLI工具，需要注意Capgo’s CLI的以下几点：

• Capgo使用单个CLI，用于开发和CI/CD用例，Capgo专注于实时更新功能集。

• The Capgo CLI 不需要单独的安装步骤。它与包一起打包，直接使用 Capgo 即可运行。 @capgo/cli __CAPGO_KEEP_0__’s __CAPGO_KEEP_1__ 是专门为实时更新工作流程设计的，因此可能不包含一般用途 __CAPGO_KEEP_2__ 工具中找到的所有功能或命令。 npx.

• Capgo’s CLI is designed specifically for the live update workflow, so it may not include some features or commands found in more general-purpose CLI tools.

标题：下一步

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

回滚

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

更新行为

自定义更新如何下载和应用到您的应用。

快速更新

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__

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

继续从概览

如果您正在使用 概览 来规划仪表板和API操作，连接它与 API概览 了解API概览中的详细实施 介绍 了解介绍中的详细实施 API密钥 了解API密钥中的详细实施 设备 为设备的实现细节，和 捆绑包 为捆绑包的实现细节，。