Capgo 让 hotfix 部署变得快速简单,跳过应用商店的审核延迟,同时确保更新安全并符合 Apple 和 Google 的指南。以下是流程的快速概览:
- 创建并测试你的 hotfix:编写精确的 code 变更,在真机上充分测试,并确保兼容性。
- 配置 Capgo:安装 Capgo CLI 配合
npx @capgo/cli init,配置加密,并与 CI/CD 工具集成。 - 上传您的热修复:使用 CLI 安全地上传更新,清晰标注,并准备部署。
- 选择更新设置:针对特定用户或群组,安排发布计划,并定义版本要求。
- 跟踪您的更新:监控交付率、更新速度和用户覆盖率。如有需要,可立即回滚。
Capgo 已在全球推送超过 9.476 亿次更新,并帮助用户将发布效率提升 81%。它是敏捷团队快速、安全部署热修复的首选工具。
步骤 1:创建并测试您的热修复
编写热修复 Code
专注于做精准修改来修复 Bug,同时不损害 App 的稳定性。
以下是组织 hotfix 的快速指南:
| 最佳实践 | 如何应用 |
|---|---|
| 隔离变更 | 将改动限制在受影响的组件内。 |
| 版本控制 | 使用专用分支进行 hotfix 开发。 |
| 文档 | 添加清晰的注释,说明修复内容及其影响。 |
| 依赖项 | 确保与现有 App 依赖项兼容。 |
凭借 Capgo 的即时更新能力,你可以专注于修复 Bug,而无需担心打包无关的变更。正如 colenso 所强调的,这种方法已被证明非常有效:
“我们推出了 Capgo OTA 更新 ,并部署到生产环境,覆盖超过 5000 名用户。运行非常平稳,在 OTA 部署到 @Capgo 后,几乎所有用户都能在几分钟内完成更新。” [1].
在设备上测试
充分测试对于确保 hotfix 无缝生效至关重要。请按以下步骤操作:
- 开发环境测试: 在本地开发环境中运行修复代码。
- 真机测试: 在各种设备和操作系统版本上检查修复效果。
- 集成测试: 确认修复不会干扰其他功能。
尽可能使用 CI/CD 工具实现测试流程的自动化。
“我们采用敏捷开发,@Capgo 对于向用户持续交付至关重要!” —— Rodrigo Mantica [1]
一旦热修复通过所有测试,就可以配置 Capgo 进行部署了。
步骤 2:设置 Capgo

安装所需软件包
要在您的 Capacitor 项目中开始使用 Capgo,请使用其 CLI 工具。只需运行以下命令:
npx @capgo/cli init
这条命令会替你完成繁重的工作:
- 安装 Capgo 插件
- 自动配置您的项目
- 让你的项目准备好使用 Capgo 服务
安装完成后,即可使用 Capgo 的加密和合规功能配置项目。
设置你的项目
Capgo 确保项目符合 Apple 和 Google 的加密与合规标准。它与 CI/CD 工具无缝集成,对更新进行加密以保障安全,并符合应用商店指南。
| 集成步骤 | 用途 | 优势 |
|---|---|---|
| CI/CD 配置 | 与 CI/CD 工具集成 | 简化部署流程 |
| 端到端加密 | 保障更新交付安全 | 维护 code 完整性 |
| 平台合规性 | 符合应用商店标准 | 实现顺畅分发 |
该配置已获开发者验证。正如 Bessie Cooper 所述:
“对于追求高效的开发者来说,@Capgo 是必备工具。能跳过审核来修复 Bug 简直太棒了。” [1]
对于大型团队,Capgo 提供多组织配置和详细的权限管理等功能。它可以与以下平台集成: GitHub, GitLab, Azure DevOps,以及 Jenkins,让自动化部署工作流变得简单直接。Rodrigo Mantica 强调了它对敏捷团队的重要性:
“我们践行敏捷开发,@Capgo 对持续向用户交付至关重要!” [1]
项目完全配置好后,你就可以上传 hotfix 并立即部署了。
步骤 3:上传 hotfix
将文件发送至 Capgo
配置好项目后,接下来可以使用 Capgo CLI 工具上传你的 hotfix。这能确保更新安全、高效地传输。首先,像平时开发那样构建你的 App。
工作原理如下:
- 按常规流程构建你的 App。
- 再次确认所有文件都能无错误编译。
- 使用 Capgo CLI 工具上传你的更新。
为更新添加标签
清晰的标签是管理和追踪热修复的关键。将更新上传到 Capgo 时,请附上具体的版本信息和描述性标签。这有助于整理更新,让团队信息保持一致。
| 标签元素 | 用途 | 最佳实践 |
|---|---|---|
| 版本号 | 跟踪更新序列 | 使用语义化版本 |
| 更新说明 | 突出关键变更 | 聚焦主要修复和更新 |
| 版本说明 | 说明变更 | 详细说明具体改进 |
Capgo 的创始人 Martin Donadieu 设计了一套版本管理系统,可与 CI/CD 工作流无缝集成。该系统让追踪更新和必要时回滚变得很简单。
Capgo 的 更新管理 还包括端到端加密和即时部署等功能,确保 hotfix 在快速送达用户的同时保持安全。
hotfix 上传并打上标签后,继续第 4 步配置更新设置。
sbb-itb-f9944d2
Capgo Live Update 系统,适用于 Capacitor 应用

步骤 4:选择更新设置
上传热修复补丁后,接下来需要配置用户定向和发布条件。这能确保部署可控且有效。
选择用户和设备
Capgo 的用户分配工具可以让你精准锁定热修复的接收对象。主要有两种策略:
| 部署类型 | 适用场景 | 优势 |
|---|---|---|
| 私有测试 | Beta 测试者、QA 团队 | 支持受控测试,获取早期反馈 |
| 正式发布 | 所有用户,分阶段推送 | 支持广泛分发,逐步部署 |
例如,如果某个 bug 影响了特定地区的用户,你可以优先针对该群体进行快速验证。选择目标受众后,即可继续设置详细的发布规则。
设置发布规则
通过 Capgo 的 Web 界面,你可以设置计划、应用版本兼容性以及更新推送的渐进程度等参数,从而精细调整发布流程。
以下是需要配置的关键设置:
- 部署计划:选择更新上线的具体时间。
- 版本要求:定义哪些应用版本应接收此更新。
- 发布比例:控制发布节奏,先小范围发布,再逐步扩大。
对于紧急修复,您可以选择立即部署以快速解决问题。对于不太关键的更新,分阶段发布让您可以监控性能,并在潜在问题出现时及时解决。此外,Capgo 还支持创建专门的测试组,让协调更顺畅、更高效。
第 5 步:追踪您的更新
密切关注热修复进度,并在问题出现时第一时间处理。
检查更新状态
Capgo 的分析功能可让您深入了解关键更新指标:
| 指标 | 监控指标 | 为什么这很重要 |
|---|---|---|
| 送达率 | 更新成功率 | 显示您的部署运行状况 |
| 更新速度 | 触达目标用户的时间 | 突出显示任何变慢或瓶颈 |
| 用户覆盖率 | 已更新的设备数量 | 显示有多少用户收到了修复 |
处理问题
查看这些指标后,请准备好快速应对任何挑战。
-
立即回滚
如果出现问题,Capgo 的回滚功能可让你立即恢复到上一版本。 -
分析用户分配情况
检查更新的分发情况,以发现特定群体或设备是否遇到了问题。 -
监控性能
利用实时指标精准定位并解决问题。Capgo 的工具可帮助判断问题出在分发、安装还是兼容性上。
业务开发人员 Rodrigo Mantica 强调了 Capgo 的重要性:
“我们践行敏捷开发,@Capgo 对持续向用户交付至关重要!” [1]
Capgo 的 Web 界面让监控更新进度变得轻而易举,提供详细的日志和性能指标。其跟踪功能已帮助各组织将发布效率提升高达 81% [1],在快速解决任何问题的同时,确保应用性能稳定。
总结
核心要点
Capgo 简化了快速高效部署热修复的流程,并拥有可靠的交付记录 9.476 亿次更新 覆盖 1,400 个生产应用 [1].
| 步骤 | 操作 | 目标 |
|---|---|---|
| 创建与测试 | 在本地开发并验证热修复 | 确保 code 质量 |
| 配置 Capgo | 使用以下命令安装插件 npx @capgo/cli init |
简化配置 |
| 上传 | 通过 CLI 传输文件 | 实现快速分发 |
| 配置 | 分配用户并设置规则 | 精准部署更新 |
| 监控 | 跟踪性能并解决问题 | 提升效率 |
按照以下步骤将 Capgo 集成到您的工作流中,从而简化您的更新流程。
快速入门
在开始之前,请先花点时间查看上述步骤。它们将部署过程拆解为可操作的任务,让实施更简单。
通过将 Capgo CLI 添加到项目中,开始集成 Capgo。有了 端到端加密,该平台可确保每次更新都安全可靠。
“Capgo 是进行热 code 推送的明智之选。”
为了更高效,你可以将 Capgo 与 Azure DevOps、GitLab 或 GitHub 等 CI/CD 工具集成。这样设置可实现自动化部署,同时通过用户分配功能让你控制更新分发。
继续阅读:用 Capgo 部署 Hotfix 的 5 个步骤
如果你正在使用 使用 Capgo 部署热修复的 5 个步骤 来规划安全与合规,请结合 加密 了解 Encryption 的实现细节, 合规性 了解合规部分的实现细节, Capgo 安全扫描器 了解 Capgo Security Scanner 的产品工作流, Capgo 安全 用于 Capgo 安全的产品工作流,以及 Capgo 信任中心 用于 Capgo 信任中心的产品工作流。