跳转到正文

概览

使用 Capgo 的 Live Updates 功能,远程实时更新应用的 JavaScript bundle。无需经过应用商店审核流程,即可直接向用户推送 JS 更新,即时修复 bug 并发布新功能。

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

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

  2. Channels 让你可以针对特定用户群推送更新。你可以用 channels 管理不同的发布轨道,例如: 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 是一款强大的工具,让开发者可以在自己的 CI/CD pipeline 中与 Capgo 的服务交互。借助 CLI,您可以精细控制构建和部署的时机,从而把 Capgo 集成到现有的企业工作流中。

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 密钥。

如果你熟悉其他 live update CLI 工具,关于 Capgo 的 CLI,有几点需要注意:

  • Capgo 在开发和 CI/CD 场景下使用同一个 CLI,因为 Capgo 只专注于 live update 功能集。

  • Capgo CLI 无需单独安装。它已随 @capgo/cli package 一起打包,可直接使用 npx.

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

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