回滚管理对于修复 应用更新 导致崩溃或 bug 的问题至关重要。借助 Capgo，您可以快速回滚到稳定版本，无需应用商店审批。以下是具体方法 Capgo 简化回滚管理：
- 快速恢复：回滚平均仅需 114 毫秒。
- 自动更新：无需人工干预 - Capgo 可无缝处理更新和回滚。
- 安全流程：端到端加密确保更新安全。
- 轻松配置：安装
@capgo/capacitor-updater几分钟内打包并配置您的应用。 - 更新通道：通过预发布、测试和生产环境控制更新。
- 手动与自动回滚：根据需求选择手动干预或自动恢复。
快速设置步骤:
- 安装
@capgo/capacitor-updater并同步您的项目。 - 配置
capacitor.config.json获取更新。 - 设置更新通道（staging、beta、production）。
- 在生产环境部署前测试回滚功能。
Capgo 通过即时解决问题，确保您的应用保持稳定且易用。无论您偏好手动控制还是自动触发，Capgo 都能为您的 Capacitor 应用提供可靠的安全保障。
设置 Capgo 用于回滚管理
要使用 Capgo 高效管理回滚，你需要安装其核心 package、配置应用设置并建立更新通道。这样可确保部署顺畅，并为处理问题提供可靠的安全网。
安装与配置 Capgo
首先添加 @capgo/capacitor-updater package 到你的 Capacitor 项目。此包用于管理应用的更新和回滚。请在项目目录中运行以下命令：
npm install @capgo/capacitor-updater
npx cap sync安装完成后，更新您的 capacitor.config.json 文件以启用更新功能。以下是一个配置示例：
{
"plugins": {
"CapacitorUpdater": {
"autoUpdate": true,
"updateUrl": "https://api.capgo.app/updates",
"privateKey": "your-private-key-here",
"version": "1.0.0",
"directUpdate": false
}
}
}- 设置
autoUpdate改为true以允许自动更新。 - 保留
directUpdate命名为false以确保更新在部署前经过验证。
接下来，将您的应用链接到 Capgo 的更新系统。请在 capgo.app注册，然后使用 CLI 注册您的应用：
npx @capgo/cli app add your-app-id此步骤将您的项目连接到 Capgo，启用版本跟踪和用户细分，以实现精确的回滚管理。
完成此初始设置后，您可以配置更新通道以控制和监控部署。
设置更新通道
更新通道有助于管理更新分发，支持充分测试，并在需要时快速回滚。
要创建通道，请使用 Capgo 的 CLI 工具。先设置三个关键通道，以便高效管理回滚：
npx @capgo/cli channel add staging
npx @capgo/cli channel add beta
npx @capgo/cli channel add production每个通道都有特定用途：
| 设置 | 用途 | 示例值 |
|---|---|---|
| Channel 名称 | 用于标识更新流 | prod、beta、staging |
| 版本模式 | 定义允许的版本格式 | 1.0.* |
| 用户访问 | 指定哪些用户接收更新 | specific-group-id |
| 更新频率 | 决定更新的分发时间 | 立即、定时 |
生产环境请使用稳定的版本模式，例如 1.0.*，而 staging 可以使用更灵活的格式进行测试。
若要进一步优化回滚管理，请设置用户分群。这样在回滚时可以针对特定群体，在有效解决问题的同时尽量减少干扰。
通过定义基于错误率、性能指标或用户反馈等条件的触发器，实现自动回滚。这些触发器可确保无需人工干预即可及时解决问题。
在部署到生产环境之前，请先在 staging channel 测试回滚功能。这一步可以确保您的回滚系统在真实场景下按预期运行。
最后，将您的更新 channel 与您的 CI/CD 流水线. 这种自动化简化了部署和回滚，让工作流保持高效，同时为意外问题提供安全保障。
如何使用 Capgo 执行回滚
Capgo 的更新验证系统可确保应用稳定，其回滚功能在此基础上提供手动和自动恢复选项。有效使用这些方法，可以帮助您在出现问题时快速恢复功能。
手动回滚步骤
手动回滚让您可以自主选择并应用稳定版本，从而在采取行动前充分评估当前情况。
首先，在您的 capacitor.config.json 文件中设置 autoUpdate 改为 false. 这会停止 Capgo 自动管理更新，让您完全掌控整个过程。
禁用自动更新后，请使用 CapacitorUpdater.download() 方法获取所需版本，并使用 CapacitorUpdater.set() 来应用该版本。示例如下：
import { CapacitorUpdater } from '@capgo/capacitor-updater'
const version = await CapacitorUpdater.download({
url: 'https://github.com/Cap-go/demo-app/releases/download/0.0.4/dist.zip',
})
await CapacitorUpdater.set(version); // Sets the new version and reloads the app使用 CapacitorUpdater.set()应用下载的版本后，应用将自动重新加载并恢复 bundle。为完成回滚流程，请务必调用 CapacitorUpdater.notifyAppReady() 以确认更新稳定。
“如果未调用此方法，您的应用将回滚到上一个成功的版本（或内置 bundle）” [2]
如果跳过此确认步骤，Capgo 将认为回滚失败，并可能触发另一次回滚，以恢复到最后一个已知可用的版本。
对于需要快速响应的场景，自动回滚可以在无需人工干预的情况下处理恢复。
自动回滚触发器
自动回滚非常适合需要持续监控的环境。它们通过检测问题并自动恢复到稳定版本来最大限度地减少停机时间。这些触发器基于健康检查和预定义的错误阈值。
设置健康检查以监控关键应用功能，例如用户身份验证或数据加载。当这些检查检测到问题时，自动触发器可以立即回滚到稳定版本。
使用性能指标定义错误阈值，以确定何时需要回滚。下表重点列出了需要考虑的关键组件：
| 组成部分 | 用途 | 实施技巧 |
|---|---|---|
| 版本控制 | 跟踪部署历史 | 持续监控进度和结果 |
| 错误阈值 | 定义回滚触发条件 | 使用特定指标自动执行回滚 |
| 响应流程 | 概述恢复步骤 | 设置工作流，即时处理问题 |
选择手动回滚还是自动回滚，取决于您的应用环境和风险承受能力。
“回滚是指重新部署 code 的先前版本。它是” 在大多数情况下是首选方案 因为在不到 5 分钟内即可消除对用户的负面影响，且不会妨碍你同时采用其他方案之一” [3]
在稳定性与安全性至关重要的生产环境中，手动回滚可以实现谨慎的评估与控制。另一方面，测试和预发布环境则能从自动化回滚的速度与效率中获益。结合这两种方法可以确保策略的平衡——通过自动化触发器处理即时故障，而将手动回滚保留给需要人工介入的复杂问题。
回滚管理最佳实践
有效的回滚策略通过结合渐进式部署与详细的回滚后分析，保护用户免受不稳定更新的影响。
分阶段发布与降低风险
分阶段发布是防止应用更新出现大规模问题的保障。与其一次性向所有用户推送变更，不如将更新逐步发布给较小的用户群。首先从占用户总数 1–5% 的测试组开始。确保该群体涵盖了多种设备类型、操作系统和使用习惯。监控其表现 24–48 小时，以捕捉任何早期故障迹象。
Feature flags 在这种情况下能救场。它们允许你立即禁用特定功能，而无需进行完整的回滚 [4].
为推进各发布阶段设定明确标准。例如，你可以根据设备稳定运行小时数或崩溃阈值等指标来做决策。一个实用的经验法则是：扩大发布范围前，先确保至少 1,000 设备小时的稳定运行。借助 Capgo 的 update channels 等工具，你可以将更新分配给特定用户组（如 beta 测试人员或早期采用者），让这一过程更轻松，并能精准控制谁在何时收到更新。
以下是分阶段发布的示例：
| 发布阶段 | 用户占比 | 监控时长 | 成功标准 |
|---|---|---|---|
| 初步测试 | 1–5% | 24–48 小时 | 崩溃率低于 0.1% 且性能正常 |
| 早期采用者 | 10–20% | 48–72 小时 | 性能稳定且用户反馈良好 |
| 正式发布 | 100% | 进行中 | 无严重问题且性能稳定 |
一旦发布趋于稳定，请将重心转向回滚后监控，确保一切运行顺畅。
回滚后的监控与诊断
完成回滚后，必须进行全面监控，确认回滚成功并防止后续问题。
设置实时告警，并跟踪崩溃率、应用启动时间、内存占用和网络性能等关键性能指标。这些指标对于评估稳定性及用户体验至关重要。对于生产环境，目标应是 99.9% 的基准稳定性，并确保在性能跌破此水平时能立即收到告警。
回滚后请至少持续监控 72 小时，以确认应用已恢复到稳定状态。密切关注直接影响用户的指标，例如应用启动速度或功能的响应速度。
使用带清晰上报流程的错误追踪工具。自动汇总回滚事件（包括原因、受影响用户和解决时间）的报告，能帮助团队从每次事故中学习。详细记录这些事件（包括触发条件、解决步骤和经验教训），对改进流程和培训团队非常有价值。
渐进式监控方法同样有效。回滚后立即进行密集观察，随着稳定性确认逐步减少监控强度。这种方法在全面监督和资源高效利用之间取得了平衡。
回滚问题排查
回滚有时会遇到阻碍用户体验的问题。知道如何快速识别并修复这些问题，是保持系统平稳运行的关键。
修复 Checksum 校验失败问题
校验和验证失败是回滚过程中可能遇到的较严重问题之一。这些失败表明更新文件在传输或存储期间已损坏或被篡改。解决方法如下：
- 仔细检查源文件和回滚 bundle 的完整性。
- 如有必要，从版本控制系统重新下载或重新生成 bundle。
Capgo 的端到端加密有助于保护传输过程中的文件安全，但本地存储仍可能出现故障。如果多名用户受到影响，请清除他们的本地缓存以删除损坏的临时文件。你可以通过 Capgo 的更新通道推送一个小型配置更新来强制重新下载，从而实现自动化。
此外，在验证下载时也要考虑网络相关问题。解决校验和问题后，继续排查潜在的版本冲突和网络挑战。
处理版本冲突与网络问题
当应用的不同部分没有正确同步时，就会出现版本冲突。遇到这种情况，请立即回滚到上一个稳定 build，尽量减少影响。借助 Capgo 的更新通道，你可以先只对特定用户群回滚测试，再逐步扩大范围。
详细日志对诊断这些冲突至关重要。查找 API 版本不匹配或数据库 schema 问题等错误，可准确判断问题出在后端变更、客户端更新，还是两者都有。
另一方面，网络问题可能会完全阻断回滚尝试。连接超时、SSL 证书错误或代理配置错误是常见原因。要解决这些问题：
- 确保所有更新端点、证书和版本标识符都是最新的。
- 在用户遇到问题的同一环境中测试网络连接。
在企业环境中，代理和防火墙规则可能会干扰更新。请与企业客户合作，将 Capgo 的更新端点加入白名单，并确认 安全策略 不会阻碍回滚流程。
| 测试场景 | 实现方式 | 成功标准 |
|---|---|---|
| 版本不匹配 | 部署不兼容的 bundle 版本 | 自动触发回滚 |
| 损坏的 Bundle | 上传损坏的更新包 | 检测到错误并恢复系统 |
| 网络故障 | 模拟网络故障 | 从上一个稳定版本恢复 |
| API 超时 | 在 API 响应中引入延迟 | 通过回退机制处理延迟 |
定期测试版本不匹配、bundle 损坏、网络故障和 API 超时等场景，能确保回滚机制足以应对真实环境中的挑战。这种主动做法能让你在生产环境出问题时更有信心。
总结
可靠的回滚策略对于保持你的应用稳定 Capacitor 应用至关重要，而 Capgo 提供了让这一过程无缝衔接的工具。它将高效的回滚 更新管理 与强大的安全措施相结合，确保你的应用始终可靠且受到保护。
Capgo 的亮点功能是它的 一键回滚能力，让你在出现问题时能快速回退到之前的版本。这能最大限度减少停机时间，并将对用户的干扰降到最低。此外，该平台确保符合 Apple 和 Google 的要求，同时 端到端加密 保障你的应用在生产环境中的安全。
“对于想提高效率的开发者来说，Capgo 是必备工具。无需审核即可修复 Bug，这一点非常宝贵。” —— Bessie Cooper [1]
这些功能简化了工作流，并在遇到挑战时提供即时解决方案。借助 CI/CD 和 semantic-release 自动化，Capgo 简化了回滚流程。无论遇到校验和验证错误、版本不匹配还是网络波动，Capgo 的基础设施和监控工具都能帮你赶在问题波及用户前解决它们。
对于在生产环境中管理 Capacitor 应用的团队，Capgo 提供了有效回滚策略所需的安全性、可靠性和简洁性。已有超过 2,000 个应用信赖该平台，你选择的方案能同时提升开发效率和用户满意度。 [1].
当问题发生时，Capgo 确保你能立即解决。
常见问题
::: 常见问题
Capgo 如何在回滚期间保障应用更新安全？
Capgo 采用 端到端加密 来保障应用更新在从创建到交付的每个阶段都安全。这能确保更新始终受到保护，并通过严格的访问控制，仅允许授权用户访问。
为保证更新完整性，Capgo 使用 密码学校验 例如哈希值和数字签名。这些工具可确认更新未被篡改。如果出现任何问题，平台的自动回滚功能让你能快速、安全地恢复到较早版本。这些功能共同确保你的应用更新既安全又可靠。 :::
::: 常见问题
相比手动回滚，使用 Capgo 实现自动回滚有哪些优势？
使用 Capgo 提供比手动回滚更快、更可靠且无错误的替代方案。当更新后出现问题时，这些回滚机制可迅速将应用恢复到稳定版本，减少停机时间，确保用户体验流畅。
自动化的独特之处在于它能消除人为错误。通过遵循预定义的最佳实践，它确保每次操作的一致性。这不仅节省了宝贵时间，还促进了更稳定、高效的应用管理方式。对于开发 Capacitor 应用的开发者来说，自动回滚提供了一种无压力、可靠的方式来处理更新。 :::
::: 常见问题
在将更新发布到生产环境之前，我该如何测试 Capgo 的回滚功能？
要有效测试 Capgo 的回滚功能，首先设置一个 Staging 环境。这允许您在更新上线前在受控环境中进行测试。邀请 测试人员 以便尽早发现潜在问题，并确保您有 实时监控 来跟踪性能并快速发现错误。同时，重要的是明确制定 回滚触发条件，例如达到特定错误率或收到特定用户反馈，这样您就能准确知道何时该回滚更新。
在发布任何更新之前，请彻底测试回滚流程。确保它可以无缝返回到之前的稳定版本，而不会引发额外问题。模拟故障场景是验证回滚机制是否按预期工作的另一种好方法。最后，充分利用 Capgo 的 分析工具 来密切关注更新性能和用户参与度。这些洞察可以指导您做出明智的决策，判断何时可能需要进行回滚。 :::
继续阅读《Capgo 回滚管理指南》
如果你正在使用 Capgo: 回滚管理指南 要规划回滚和版本控制，请将其与 回滚 有关 Rollbacks 的实现细节， 版本定向 有关 Version Targeting 的实现细节， 更新行为 有关 Update Behavior 的实现细节， bundle 有关 bundle 的实现细节，以及 Capgo Live Update 有关 Capgo Live Updates 的产品工作流。
