Capgo 简化了在空中（OTA）更新的过程， Capacitor 使开发者能够立即推送更新，而不受应用商店延迟。以下是您需要了解的内容：
- 什么是 Capgo？ 一个开源的插件，用于安全地 实时更新 JavaScript 和资产到应用程序。
- 为什么要使用它？ 更新可以在 24 小时内到达 95% 的用户，具有端到端加密、CI/CD 集成和回滚选项。
- 主要功能:
- 自动更新计划 精确发布.
- 频道支持 测试或分阶段发布.
- 性能统计: 434ms API 响应时间，114ms 下载 5MB
- 设置步骤: 安装插件配置设置，并 启用自动更新 __CAPGO_KEEP_0__
CapacitorUpdater.notifyAppReady().
Capgo 确保更新速度快、安全且用户友好，使其成为频繁更新应用的开发者必备工具。
设置 Capgo 用于更新计划
要使用 Capgo 进行更新计划，您需要安装插件、设置项目并配置自动更新功能以满足您的需求。该过程确保您的应用可以高效地处理更新，同时保持与 Capgo 服务器的兼容性。 安装和配置插件 to suit your needs. This process ensures your app can handle updates efficiently while maintaining compatibility with Capgo’s server.
__CAPGO_KEEP_0__ 更新器插件
。运行以下命令： Capgo__CAPGO_KEEP_0__
npm install @capgo/capacitor-updater
npx cap sync
npx @capgo/cli init接下来，配置您的应用设置在 capacitor.config.ts 或 capacitor.config.json 文件中。两个关键字段 - appId 和 version - 确定您的应用与Capgo服务器并确保更新兼容。确保您的应用版本遵循 语义版本 (例如，1.0.0) [4].
以下是基本配置的示例在 capacitor.config.json:
| 设置 | 目的 | Example Value |
|---|---|---|
autoUpdate | 自动更新 | true |
updateUrl | 更新检查地址 | 'https://api.capgo.app/updates' |
appId | 标识您的应用程序到 Capgo | 'com.yourcompany.yourapp' |
version | 当前应用程序版本 | '1.0.0' |
在开发期间，设置 autoUpdate 为 false。这防止系统将更新覆盖您的工作。您的应用程序准备就绪后，切换 autoUpdate 回 true 以便为您的用户启用更新。
设置自动更新功能
启用自动更新后，Capgo 可以处理后台下载和安装。系统定期检查更新并确保用户始终拥有最新版本的应用程序。
One key step is implementing the __CAPGO_KEEP_0__ within your app. Use the __CAPGO_KEEP_1__ method as early as possible after the app starts. This confirms that the new version is functioning properly. If the __CAPGO_KEEP_0__ isn’t called within the specified timeout, the system will revert to the last working version notifyAppReady() 以下是用于微调自动更新行为的配置选项: CapacitorUpdater.notifyAppReady() 设置 [4].
描述
| 默认值 | 等待更新失败前的时间（毫秒） | 10秒 |
|---|---|---|
appReadyTimeout | 等待__CAPGO_KEEP_0__请求响应的时间（秒） | 10000 自动删除失败的更新包 |
responseTimeout | Time (in seconds) to wait for API requests to respond | 20 |
autoDeleteFailed | 10秒 | true |
autoDeletePrevious | 10秒 | true |
directUpdate | 直接在应用更新/安装时安装更新 | undefined |
defaultChannel | 设置默认更新频道 | undefined |
这个 statsUrl ，默认值为 https://api.capgo.app/stats，允许您通过Capgo的分析仪表板监控更新的性能和成功率 [6].
对于生产环境，使用CI/CD管道上传新版本是非常推荐的。这确保了您的更新过程的一致性，并最小化了在发布过程中手动错误的风险 [4].
最后，记住，OTA更新仅限于HTML、CSS和JavaScript文件的更改 [5][7]任何nativecode的修改都需要通过应用商店提交更新版本
如何安排和优先级更新
一旦您配置了更新系统，下一步就是计划何时和如何交付更新。使用智能调度和优先级确保更新以最小的干扰用户的方式高效地发布
基于应用状态的更新排程
最佳的时间更新是通过了解应用的行为和用户如何与其互动。工具如Capgo让您定义 延迟条件延迟更新直到满足某些标准 - 比如应用程序处于后台或特定日期到来时 [3][10].
例如，您可以使用Capacitor的App插件与Capgo更新器结合使用，来跟踪应用程序进入空闲状态的时间。这一设置允许您在低活动期触发更新检查，确保用户体验更加Smooth。
考虑网络和设备条件
一个好的调度策略也要考虑网络和设备条件在开始下载之前。对于较大的更新，优先 Wi-Fi连接 以避免使用蜂窝数据，后者可能导致下载不完整。
电池寿命是另一个关键因素。更新应只在设备有足够的电力才能完成安装时才进行。Capgo允许您编程这些检查，确保更新只在条件理想时才启动。一旦这些基础设定就位，您就可以专注于为不同用户组优先更新
为不同用户组优先更新
Capgo提供了工具来为各种用户群组定制更新策略，通过使用独立的通道。这一方法确保更新以每个群组的需求相符的方式进行传递。
| 用户群组 | 通道类型 | 更新策略 |
|---|---|---|
| 高级用户 | 测试频道 | 获取新功能的早期访问 |
| 普通用户 | 生产频道 | 优先考虑稳定性的渐进式更新 |
| 低活跃用户 | 稳定频道 | 更新重点关注核心功能 |
为了获得更多的控制权，您可以实现基于百分比的滚动发布或允许特定组选择加入 [9]这种方法尤其适用于QA团队或需要特定功能的组织 控制更新过程.
对于较简单的应用程序，建议使用单独的渠道。对于拥有多样化用户群的应用程序，考虑结合多种策略来满足各个需求。
测试和监控更新计划
一旦您设置了更新计划策略，接下来就是确保一切顺利地运行，直到将其发布给用户。测试和监控是捕捉潜在问题的关键步骤，确保更新体验顺畅。
如何测试更新计划
测试 预定更新 需要一个与生产环境非常相似的环境。这确保了在测试过程中遇到的任何问题都很可能反映真实世界的场景。
要开始测试，您需要特定的工具和软件版本。您的测试环境应该包括：
更新检测、下载、安装和回滚。每个阶段应满足严格的性能和可靠性标准。 测试类型__CAPGO_KEEP_0__
| __CAPGO_KEEP_0__ | 重点领域 | 目标指标 |
|---|---|---|
| 更新检测 | 版本检查 | ~434ms响应时间 |
| 下载过程 | 捆绑下载 | 5MB捆绑在~114ms内 |
| 安装 | 更新应用 | 成功集成 |
| 回滚 | 版本回滚 | 回滚成功 |
请注意配置细节，因为文件中的版本号不匹配可能会干扰更新过程。确认所有版本号与部署设置一致 capacitor.config.json 此外，请确保更新仅在特定条件下触发，例如应用程序处于后台或Wi-Fi可用时。模拟中断场景，如网络中断，来测试系统的韧性
彻底测试是有效性能跟踪的前提条件，更新发布后
跟踪更新性能
测试完成后，重点转向监控更新在实时中的表现。这一步对于维护可靠的更新系统至关重要
__CAPGO_KEEP_0__提供实时分析，立即为您提供更新性能的见解。通过其仪表板，您可以跟踪关键指标，如更新成功率、下载速度和用户参与度模式
“实时跟踪更新成功率和用户参与度” - Capgo
Capgo的数据突出了优化的更新系统可以实现的成就。例如，95%的活跃用户通常在24小时内更新，平台报告全球更新成功率为82% [8]
Capgo’s data highlights what a well-optimized update system can achieve. For example, 95% of active users are typically updated within 24 hours, and the platform reports an 82% global success rate for updates [8]__CAPGO_KEEP_0__
Error tracking is another valuable feature. Capgo captures logs and metrics, helping you identify patterns in failed updates or slow downloads before they escalate. If an update creates unexpected issues, Capgo’s one-click rollback feature allows you to quickly revert to a previous version.
“One-click rollback to any previous version if needed” - Capgo [8]
为了进一步优化您的更新策略，监控不同用户段和设备类型的性能。Capgo的 渠道系统 让您可以针对特定群体进行阶段性发布，减少广泛问题的风险。设置警报来监控关键指标，例如高失败率或异常慢下载速度，以便您可以及时解决问题。持续监控不仅有助于快速解决问题，还可以改进您的更新过程，进而提高性能和用户满意度。
最佳实践和高级方法
一旦您掌握了基本的调度和监控，您就可以探索高级策略来提升OTA更新系统的水平。这些方法可以改进性能、减轻服务器负担和增强安全性。
使用分段和时间更新
分段发布是减少风险和更有效地管理服务器资源的聪明方法。您不需要一次性推送更新给所有人，而是可以控制发布的速度和时间，确保更平滑的过程。
利用Capgo的频道系统来管理这些分段的发布。例如，先从一小群beta用户开始测试更新。一次你对其有信心，逐渐扩大发布到更大的用户组中。
基于时间的部署是另一个有用的策略。通过在非高峰时间-例如晚上或周末-预订更新，可以最小化对用户工作流程的干扰。这对于业务应用尤其重要，因为可用性是关键的。
Capgo结合了 Cloudflare 和 Supabase 来可靠地处理高容量发布。 [12]你也可能考虑24小时的采用周期，目标是达到95%的活跃用户。这一方法给你足够的时间来监控每个阶段，同时保持快速的部署速度。
使更新包更小
更小的更新包意味着更快的下载和更少的用户带宽压力。一个有效的方法是差异更新，它只发送自上一个版本以来发生的变化，从而减少传输的数据量 [11].
使用带有重试机制的传输协议也是至关重要的。这些确保更新可以在下载中断时恢复到上一次停止的位置 [11].
设置性能目标来提高用户体验。例如，目标是通过CDN下载5MB包的速度小于500ms，交付时间小于150ms。这些基准确保用户在更新时面临的延迟最小，补充了高效的调度实践。
Maintaining Security and Compliance
安全应该是您的更新流程中的首要考虑因素。通过端到端加密保护您的更新，确保安全传输和存储。这在今天的联网世界中是不可谈判的。
安全审计和渗透测试是识别和修复漏洞的关键 [13]远程攻击的增加 - 2023年汽车网络攻击的95%以上 - 强调了建立强大防御的必要性 [13].
汽车行业最近发生的事件表明，快速响应漏洞的重要性 [13]为了保持领先地位，实施多层次安全监控系统并制定明确的应急响应协议：
| 警报级别 | 触发器 | 响应动作 |
|---|---|---|
| 低 | 异常访问模式 | 立即调查并记录发现 |
| 中等 | 多次操作失败 | 暂时停止关键功能 |
| 高 | 已确认被攻击 | 立即更换密钥 |
| 严重 | 已知漏洞正在被利用 | 立即更换所有系统密钥 |
安全措施应涵盖数据加密、安全存储、强制 HTTPS 连接和基于角色的访问控制等方面。定期进行 SSL/TLS 验证和身份验证测试将有助于确保这些保护措施有效。
最后，保持用户知情和参与。提供清晰的通知，告知用户即将到来的更新，详细说明哪些内容会改变以及他们可能需要采取的行动 [11]为用户提供选项，允许他们预约或延迟更新，这不仅会改善他们的体验，还有助于满足监管要求
概要和下一步
现在您已经探索了Capgo OTA 安全更新工具的全部功能，您就具备了高效管理更新的能力 - 平衡速度、安全性和用户体验。从安装和配置到高级发布策略和安全措施，这些技术使您成功。
有效的计划关键在于从小开始，监控性能指标，并逐渐扩大。例如，在结合了一个良好的发布计划和可靠的基础设施的情况下，实现 24 小时内 95% 的采用率是完全可能的。 [1]这些实践确保 smooth updates 同时保持高性能。
“Capgo 解决了Capacitor 应用程序开发人员面临的一个重大问题：如何快速部署更新而不需要经过繁琐的应用商店流程。它做到了这一点，提供了一个强大的解决方案。” - Thomas Sanlis, Uneed Review [2]
Capgo 的简单性是其突出的特点之一。在 2025 年 4 月，来自 Uneed 的 Thomas Sanlis 展示了它的易用性。没有任何Capacitor经验，他在约 20 分钟内安装了Capgo，并在 Nuxt 3 项目中完成了此操作。他然后模拟了一个 bug 修复，编辑了主页的文本，然后重新部署了更新 - 所有这一切都在一分钟内完成。 准备发布更新？开始使用一个 15 天免费试用 [2].
15天免费试用 15天免费试用 To explore Capgo的调度功能并了解它们如何与您的应用需求相匹配 [2]. 当您准备部署时，CLI命令 npx @capgo/cli@latest bundle upload --channel=production 使部署过程变得顺畅 [2].
跟踪更新采用率、设置自动错误跟踪以快速回滚以及使用分阶段发布来控制交付 . 确保您的应用程序确认更新，如前所述 [1]在OTA更新的不断演变中，__CAPGO_KEEP_0__作为可靠的长期解决方案而脱颖而出。其开源基础和遵守苹果和安卓指南的兼容性确保它将来也能满足您的需求 [4].
立即开始实施这些策略以使您的更新过程更加高效并保持用户满意。Capgo的工具将有助于您简化部署并提高整体体验
Start implementing these strategies today to make your update process more efficient and keep your users satisfied. Capgo’s tools are here to help you streamline deployments and enhance the overall experience.
::: faq
__CAPGO_KEEP_0__如何为__CAPGO_KEEP_1__应用程序保持OTA更新的安全性
Capgo为Capacitor应用程序的OTA更新提供安全性
Capgo的调度功能 Capacitor 应用 通过 端到端加密,确保更新数据在创建到用户设备交付期间保持受保护。这种方法防止了在传输过程中任何拦截或篡改。
为了进一步加强安全性，Capgo 使用了先进的密钥管理技术。通过实施 加密算法 如 RSA-4096 和 AES-256，__CAPGO_KEEP_0__ 安全地生成和存储密钥。每个更新也被验证和监控其完整性之前部署，添加了另一个保护层。
这些措施在位，开发者可以有信心地交付更新，保持用户数据安全，同时满足平台安全标准。
:::
What are the best practices for testing and monitoring scheduled updates with Capgo?
如何测试和监控Capgo预定更新的最佳实践?
- 为了使__CAPGO_KEEP_0__预定更新尽可能顺畅和有效，以下是一些建议值得注意： 通过使用如差分更新和压缩等方法。 这不仅可以加快下载速度，还可以帮助减少用户启动应用程序时的延迟。
- 计划在非高峰时间更新 以最小化中断。 将此与分阶段发布相结合，以逐渐引入更改。这有助于您在实时监控性能并快速修复任何问题时。
- 利用 实时分析 来跟踪更新的性能并衡量用户参与度。 添加自动回滚功能确保失败的更新可以快速恢复，保持用户体验smooth和不受干扰。
通过遵循这些步骤，开发人员可以高效地管理更新，同时保持用户满意。 :::
::: faq
如何使用Capgo的频道系统来为不同用户组优先更新？
使用Capgo的频道系统，您可以通过创建特定的频道，如 生产, 测试或 测试。 这个方法允许您将更新分发给特定的用户，测试新功能与较小的受众，快速推送紧急修复 -ypassing app store 的审批需要。
您还可以分配角色，如 管理员, 开发者或 查看者 来管理每个频道的访问权限和权限。这一结构简化了分阶段测试，并确保更新逐渐有效地部署到您的用户。
Keep going from Capgo Plugin: Scheduling Updates Tutorial
__CAPGO_KEEP_0__ Capgo Plugin: Scheduling Updates Tutorial 为了计划安全性和合规性，连接它与 加密 在加密中的实施细节 合规 在合规中的实施细节 Capgo 安全扫描器 在Capgo 安全扫描器中的产品工作流 Capgo 安全 在Capgo 安全中的产品工作流 Capgo 信任中心 在Capgo 信任中心中的产品工作流
