概述

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

始终使用最新的 CLI

始终使用 Capgo CLI @latest 例如 npx @capgo/cli@latest). The CLI follows its own versioning and does __CAPGO_KEEP_0__遵循自己的版本号，不需要与插件的主版本或__CAPGO_KEEP_0__的主版本匹配。最新的__CAPGO_KEEP_1__与任何受支持的更新插件版本兼容。请参阅 need to match your plugin major or Capacitor major. The latest CLI stays compatible with any supported updater plugin version. See Capgo versioning.

注意

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

实时更新的工作原理

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

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

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

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

开始使用

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

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

2. 在您的应用 code 中，调用 CapacitorUpdater.notifyAppReady() 在您的应用 Capgo 初始化完成后调用此函数。 这告诉 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来处理开发和CI/CD用例，因为CLI专注于实时更新功能集。

• Capgo uses a single CLI for both development and CI/CD use cases, as Capgo is focused solely on the live update feature set.

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

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

下一步

频道

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

回滚

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

更新行为

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

快速更新

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

继续从概览

如果您正在使用 概览 to plan dashboard and API operations, connect it with API for the implementation detail in API Overview, 进行连接 在 API for the implementation detail in API Keys, 中了解详细信息, 为设备中的实现细节， 捆绑包 为捆绑包中的实现细节。