跳过内容

概述

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

Capgo’s Live Update system has two key components:

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

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

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

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

  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 is a powerful tool that allows developers to interact with Capgo’s services from their own CI/CD pipelines. With the CLI, you have granular control over when builds are produced and deployed, enabling you to integrate Capgo into your existing enterprise workflows.

What is the Capgo CLI for?

标题:什么是 Capgo CLI?

Capgo CLI 是为需要在 live update 流程中拥有更多控制和灵活性的开发者和团队设计的。通过在 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工具的主要区别

如果您熟悉其他实时更新CLI工具,了解Capgo的CLI的以下几点很重要:

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

  • Capgo的CLI不需要单独的安装步骤。它与包一起打包,可以直接使用 @capgo/cli __CAPGO_KEEP_0__的__CAPGO_KEEP_1__专门设计用于实时更新工作流,因此它可能不包括更通用__CAPGO_KEEP_2__工具中找到的某些功能或命令。 npx.

  • Capgo’s CLI is designed specifically for the live update workflow, so it may not include some features or commands found in more general-purpose CLI tools.

标题:下一步

频道