跳转到内容

概述

使用 Capgo 的实时更新功能远程实时更新应用的 JavaScript bundle。直接向用户推送 JS 更新,无需通过应用商店审核流程即可立即修复错误和发布新功能。

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

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

  2. 频道,让您将更新定向到特定的用户组。您可以使用频道来管理不同的发布轨道,例如 ProductionStagingDev

当您上传新的 JS bundle 到 Capgo 并将其分配给频道时,为该频道配置的应用中的 Capgo SDK 将检测到更新并下载它。下次应用重新启动时,将加载新的 bundle。

要开始使用实时更新,请按照以下步骤操作:

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

  2. 在您的应用代码中,在应用完成初始化后调用 CapacitorUpdater.notifyAppReady()。这告诉 Capgo SDK 您的应用已准备好接收更新。

  3. 构建您的 JS bundle 并将其上传到 Capgo:

    Terminal window
    npm run build
    npx @capgo/cli@latest bundle upload --channel=production
  4. 打开您的应用并等待更新下载。您可以使用以下命令检查状态:

    Terminal window
    npx @capgo/cli@latest app debug
  5. 下载更新后,关闭并重新打开您的应用以加载新的 bundle。

有关更多详细信息,请参阅 部署实时更新 指南。

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

Capgo CLI 为需要在实时更新工作流中获得更多控制和灵活性的开发者和团队而设计。通过在 CI/CD 管道中使用 CLI,您可以:

  • 准确决定何时构建和部署更新,而不是依赖 Capgo 的内置自动化
  • 插入您自己的流程,例如代码签名、QA 测试或管理员批准,在构建和部署步骤之间
  • 将 Capgo 集成到现有的 DevOps 工具和工作流中

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

要登录并安全地存储您的 API 密钥,请运行:

Terminal window
npx @capgo/cli@latest login [API_KEY]

此命令将保存供今后使用。登录后,您无需为每个命令都提供 API 密钥。

如果您熟悉其他实时更新 CLI 工具,有一些关于 Capgo CLI 的关键点需要注意:

  • Capgo 将单个 CLI 用于开发和 CI/CD 用例,因为 Capgo 仅专注于实时更新功能集。

  • Capgo CLI 不需要单独的安装步骤。它与 @capgo/cli 包捆绑在一起,可以直接使用 npx 运行。

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