概述

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

始终使用最新的 CLI

始终使用 Capgo CLI @latest (例如 npx @capgo/cli@latest)。 CLI遵循自己的版本管理，并且 不 需要与插件的主要版本或 Capacitor 的主要版本匹配。最新的 CLI 与任何支持的更新插件版本兼容。请参阅 Capgo 版本管理.

注意

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

实时更新的工作原理

Capgo 的实时更新系统有两个关键组成部分:

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

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

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

开始使用

__CAPGO_KEEP_0__’s Live Update system has two key components:

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 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的CLI：

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

• CapgoCLI不需要单独的安装步骤。它与 @capgo/cli 使用包并可以直接使用 npx.

• Capgo的CLI是专门为实时更新工作流程设计的，因此它可能不包括一些通用CLI工具中找到的特性或命令。

下一步

频道

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

回滚

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

更新行为

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

快速更新

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

继续从概述中开始

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