概述

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

注意

实时更新仅限于 JavaScript 包的更改。如果您需要更新本机 code，例如添加或删除插件或更改本机项目配置，则需要提交新的本机二进制构建到应用商店。

实时更新的工作原理

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

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

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

当您在Capgo中上传一个新的JS包并将其分配到一个频道时，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. 下载更新后，关闭并重新打开您的应用程序以加载新包。

查看 实时更新部署 指南以获取更多详细信息。

The Capgo CLI

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

什么是Capgo CLI?

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

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

身份验证

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

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

npx @capgo/cli@latest login [API_KEY]

此命令将在登录后保存为以后使用。您不需要每次提供您的API密钥。

与其他CLI工具的主要区别

如果您熟悉其他实时更新CLI工具，以下是Capgo’sCLI的几个关键点：

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

• Capgo CLI不需要单独的安装步骤。它与包一起打包，可以直接使用 @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包版本，如果更新引起问题。

更新行为

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

快速更新

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

继续从概览

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