概览

利用 Capgo 的 Live Updates 功能，实时远程更新应用的 JavaScript bundle。无需经过 App Store 审核，即可直接向用户推送 JS 更新，从而快速修复 Bug 并发布新功能。

请始终使用最新版本的 CLI

请始终配合以下命令运行 Capgo CLI @latest （例如 npx @capgo/cli@latest). CLI 遵循其自身的版本控制，因此不 不 必与您的插件主版本或 Capacitor 主版本保持一致。最新的 CLI 与任何受支持的 updater 插件版本保持兼容。详见 Capgo 版本控制.

注意

Live Updates 仅限于 JavaScript bundle 的变更。如果您需要更新 native code（例如添加或删除插件，或更改 native 项目配置），则需要向应用商店提交新的 native binary build。

Live Updates 工作原理

Capgo 的 Live Update 系统包含两个核心组件：

1. 您在应用中安装的 Capgo SDK。SDK 会在后台检查可用更新并进行下载。

2. Channel 可让你针对特定用户群推送更新。你可以使用 channel 来管理不同的发布轨道，例如： Production, Staging，以及 Dev.

当你向 Capgo 上传新的 JS bundle 并将其分配给某个 channel 时，配置了该 channel 的应用中的 Capgo SDK 会检测到更新并进行下载。下次应用重启时，新的 bundle 就会被加载。

快速入门

要开始使用 Live Updates，请按照以下步骤操作：

1. 完成 Capgo 快速入门指南 以在 Capgo 中配置你的应用并安装 Capgo SDK。

2. 在你的应用 code 中，在 CapacitorUpdater.notifyAppReady() 应用初始化完成后调用。这会告知 Capgo SDK 你的应用已准备好接收更新。

3. 构建你的 JS bundle 并将其上传到 Capgo：

   npm run build
   npx @capgo/cli@latest bundle upload --channel=production

4. 打开您的应用并等待更新下载。您可以通过以下方式查看状态：

   npx @capgo/cli@latest app debug

5. 更新下载完成后，请关闭并重新打开应用以加载新的 bundle。

请参阅 部署 Live Updates 指南了解更多详情。

Capgo CLI

Capgo CLI 是一款强大的工具，允许开发者通过自己的 CI/CD pipeline 与 Capgo 的服务进行交互。借助 CLI，您可以精细控制 build 的生成与部署时机，从而将 Capgo 集成到现有的企业工作流中。

Capgo CLI 是做什么用的？

Capgo CLI 专为需要在 live update 工作流中获得更多控制权和灵活性的开发者及团队设计。通过在 CI/CD pipeline 中使用 CLI，你可以：

• 精确决定何时构建和部署更新，而不是依赖 Capgo 的内置自动化
• 在构建和部署步骤之间插入自定义流程，例如 code 签名、QA 测试或管理层审批
• 将 Capgo 集成到你现有的 DevOps 工具链和工作流中

身份验证

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

运行以下命令以登录并安全存储你的 API 密钥：

npx @capgo/cli@latest login [API_KEY]

该命令随后将被保存以供后续使用。登录后，您无需在每次执行命令时都提供 API key。

与其他 CLI 工具的主要区别

如果您熟悉其他 live update CLI 工具，那么关于 Capgo 的 CLI，有几点需要注意：

• Capgo 在开发和 CI/CD 场景下使用统一的 CLI，因为 Capgo 专注于 live update 功能集。

• Capgo CLI 无需单独安装步骤。它已包含在 @capgo/cli package 中，并可以直接使用 npx.

• Capgo 的 CLI 是专为 live update 工作流设计的，因此可能不包含某些通用型 CLI 工具中的功能或命令。

下一步

渠道

了解如何使用 channels 来管理不同的发布轨道，并将更新推送给特定用户。

回滚

了解更新引发问题时，如何回滚到之前的 JS bundle 版本。

更新行为

自定义应用中更新的下载和应用方式与时机。

快速更新

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

从概览继续

如果你正在使用 概览 来规划 dashboard 和 API 操作，请将其连接至 API 概览 关于 API 概览中的实现细节， 简介 有关 Introduction 中的实现细节， API 密钥 关于 API Keys 中的实现细节， 设备 关于 Devices 中的实现细节，以及 Bundle 关于 Bundles 中的实现细节。