通道
学习如何使用 channels 管理不同的发布轨道,并将更新定向推送给特定用户。
复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。
使用 Capgo 的 Live Updates 功能,远程实时更新应用的 JavaScript bundle。无需经过应用商店审核流程,即可直接向用户推送 JS 更新,即时修复 bug 并发布新功能。
Capgo 的 Live Update 系统有两个关键组件:
你安装在应用中的 Capgo SDK。SDK 会在后台检查可用更新并下载。
Channels 让你可以针对特定用户群推送更新。你可以用 channels 管理不同的发布轨道,例如: Production, Staging,以及 Dev.
当你向 Capgo 上传新的 JS bundle 并将其分配给某个 channel 时,针对该 channel 配置的应用中的 Capgo SDK 会检测到更新并下载。应用下次重启时,将加载新的 bundle。
要开始使用 Live Updates,请按以下步骤操作:
完成 Capgo 快速入门 在 Capgo 中设置你的应用并安装 Capgo SDK。
在应用 code 中,调用 CapacitorUpdater.notifyAppReady() 在应用初始化完成后。这会告知 Capgo SDK 你的应用已准备好接收更新。
构建你的 JS bundle 并上传到 Capgo:
npm run buildnpx @capgo/cli@latest bundle upload --channel=production打开应用并等待更新下载。你可以用以下方式查看状态:
npx @capgo/cli@latest app debug更新下载完成后,关闭并重新打开应用以加载新的 bundle。
请参阅 部署 Live Updates 指南了解更多详情。
Capgo CLI 是一款强大的工具,让开发者可以在自己的 CI/CD pipeline 中与 Capgo 的服务交互。借助 CLI,您可以精细控制构建和部署的时机,从而把 Capgo 集成到现有的企业工作流中。
Capgo CLI 面向需要在 live update 工作流中拥有更多控制权和灵活性的开发者和团队。在 CI/CD pipeline 中使用 CLI,您可以:
要使用 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 工具中的某些功能或命令。
通道
学习如何使用 channels 管理不同的发布轨道,并将更新定向推送给特定用户。
回滚
了解当更新引发问题时,如何回滚到之前的 JS bundle 版本。
更新行为
自定义应用内更新的下载与应用方式及时机。
快速更新
了解如何使用快速更新来加速更新流程。
如果你正在使用 概览 要规划 dashboard 和 API 操作,请将其连接到 API 概览 关于 API Overview 中的实现细节, 简介 关于 Introduction 中的实现细节, API 密钥 有关 API Keys 的实现细节, 设备 有关 Devices 的实现细节,以及 Bundle 有关 Bundles 中的实现细节。