想立即将应用程序更新推送给用户，而不必等待应用商店批准吗？ Capacitor’s Over-the-Air (OTA) 更新让您可以实时更新应用程序的网页内容。 但是，要确保顺利部署，需要坚实的版本控制实践。
本指南将教您以下内容：
-
为什么 OTA 更新可以节省时间： 跳过应用商店延迟，提高效率至 81%.
-
如何管理版本： 使用 Semantic Versioning (MAJOR.MINOR.PATCH) 来有效跟踪更新。
-
避免的常见陷阱： 不匹配的构建、失败的配置和更新可追踪性问题。
-
最佳工具： 工具如
capacitor-sync-version-cli和 Capgo 简化版本管理和部署。 -
更新策略： 选择部分和完整更新、分阶段发布和可选或必需更新。
快速提示： 从版本开始， 0.1.0为新功能增加MINOR版本号，
为bug修复增加PATCH版本号。 Capacitor OTA updates准备好简化您的
__CAPGO_KEEP_0__
语义版本控制 Capacitor
管理 Capacitor OTA 更新需要清晰的版本控制策略。以下是如何保持稳定并确保更新顺利进行的方法。
语义版本控制基础
语义版本控制（SemVer）是广泛使用的版本编号方法，结构为 MAJOR.MINOR.PATCH。每个部分都有特定的作用：
| 版本组件 | 目的 | 何时更新 |
|---|---|---|
| MAJOR (X) | 表示破坏性更改 | 当引入 API 不兼容性时 |
| MINOR (Y) | 添加新功能 | 当添加向后兼容的功能时 |
| PATCH (Z) | 修复bug | 当实现向后兼容的修复时 |
苹果下载的code的指南值得注意：
“Interpreted code may be downloaded to an Application, but only so long as such code: (a) does not change the primary purpose of the Application by providing features or functionality that are inconsistent with the intended and advertised purpose of the Application as submitted to the App Store (b) does not create a store or storefront for other code or applications (c) does not bypass signing, sandbox, or other security features of the OS.” [2]
(a) 不改变应用程序的主要目的，提供与应用程序提交到 App Store 声明的目的不一致的功能或功能 (b) 不创建其他__CAPGO_KEEP_2__或应用程序的商店或商店 (c) 不绕过签名、沙盒或操作系统的其他安全功能。
To manage Capacitor OTA updates effectively, developers can use tools like capacitor-set-version 为了有效地管理__CAPGO_KEEP_0__ OTA 更新，开发者可以使用工具，如 capacitor-sync-version-cli和 这些工具简化版本管理，通过 横跨各个平台。
开始之前，请参阅以下步骤：
-
自动版本同步: 使用
capacitor-sync-version-cli来保持所有平台的版本号一致。 -
构建验证: 在每次构建之前设置检查，以确认提交证据。
-
配置验证: 自动验证Capacitor设置以避免配置错误。
从版本 0.1.0开始，并为每个新功能增加次要版本号。按照这些步骤可以减少错误，但仍然需要避免常见的错误。
常见的版本控制错误
即使有良好的实践在位，错误也可能发生。类似于 capsafe 可以帮助识别并预防针对每个平台的具体问题。以下是需要关注的内容：
-
构建验证:自动检查提交证据文件并确保跨平台的构建同步。
-
平台特定版本:关注iOS和Android版本代码，以避免不匹配。
-
更新验证:确认OTA更新不会干扰应用的核心功能。
对于iOS构建， capsafe 确保 ios/App/public/commit-evidence.json 文件存在。这一步至关重要，以避免部署过时的Web构建。 [3]正确的验证确保更新可靠，减少了破坏性发布的风险。
OTA更新管理方法
选择合适的传输方法、测试策略和更新政策对于管理Capacitor OTA更新至关重要。以下是主要方法的分解，以确保更新顺利高效。
部分更新 vs 完整更新
决定使用部分更新还是完整更新会影响应用程序性能和用户体验。部分更新主要关注web资产，如 JavaScript捆绑包,使其成为快速修复或小型UI调整的理想选择。另一方面，完整更新在涉及本机code更改时是必需的，因为它们会替换整个应用程序捆绑包。
| 更新类型 | 适合 | 优点 | 需要注意的事项 |
|---|---|---|---|
| 部分 | 修复bug、UI调整 | 更小的下载，更新更快 | 仅限于网页内容。确保更改与应用程序的原始意图保持一致 [2]. |
| 完整 | 原生code更新 | 全面修改 | 更大的下载和更长的安装时间 |
对于部分更新，您可以从 dist/ 或 www/ 更新特定资产而不替换整个应用程序的原生文件系统中提取编译的应用程序包。
分阶段发布和测试
分阶段发布允许更新逐渐发布，降低风险并为您提供时间来捕捉潜在问题。使用 App Store ConnectCapgo 的分阶段发布系统，更新在七天内分发，随着每天更新的用户比例逐渐增加：
| 第 | 用户比例 | 建议操作 |
|---|---|---|
| 1–2 | 1–2% | 监控崩溃报告并收集反馈。 |
| 3–4 | 5–10% | 跟踪性能指标。 |
| 5–6 | 20–50% | 评估用户参与度。 |
| 7 | 100% | 完成发布。 |
例如，Supercell 在 2024 年 1 月为 “Clash of Clans” 的更新采用了这种策略。在 10% 的发布阶段，他们发现了一个关键 bug 并暂停了发布以解决它，从而避免了对全球用户的广泛问题 [4].
必需更新与可选更新
Striking a balance between app functionality and user experience is crucial when deciding on required or optional updates. For critical fixes, a force update may be necessary, but it should be used sparingly to avoid frustrating users. The Capacitor SDK offers options for update modes, including:
“We generally don’t recommend this mode since it can lead to the splash screen showing for a long time, especially if the user is on a poor network connection.”
– Capacitor SDK 安装 – Appflow，强制更新
为了在关键工作流程，如身份验证期间保持smooth用户体验，考虑实现阻止更新的机制。例如：
// Before login
localStorage.shouldBlockReload = true;
// After successful login
localStorage.shouldBlockReload = false;另外，后台更新允许用户继续使用当前版本，同时新版本在后台下载。
这些策略为管理更新提供了坚实的基础，同时尽量减少干扰。下一节将深入探讨更新策略和安全考虑。
sbb-itb-f9944d2
更新规则和安全
OTA更新需要遵守应用商店政策和严格的安全协议。
应用商店更新政策
苹果和Google Play严格规定应用程序必须保持安全和高质量。例如，自2024年8月31日起，Google Play要求所有新应用和更新都必须针对Android 14（API 等级34）[8]。开发者可以在2024年11月1日之前申请延期，如果他们需要更多时间。
以下是某些基于时间的更新控制方法：
| 更新控制方法 | 描述 | 好处 |
|---|---|---|
| 延迟更新 | 推迟更新 1–90 天后发布 | 允许控制测试和逐渐部署 |
| 版本控制 | 决定哪些应用程序版本接收更新 | 支持分阶段部署和测试 |
| 自动更新 | 在管理设备上设置更新行为 | 简化维护 |
为了强制执行截止日期，使用系统通知。研究表明，持续、有计划的更新可以提高用户参与度达200%[9].除了满足应用商店的规则之外，确保更新的安全性同样重要
更新安全标准
强大的版本控制对于维护更新完整性至关重要，但同样重要的也是层次化的安全措施。通过加密、身份验证和完整性检查来确保OTA更新的安全性。aicas的创始人、CEO和CTO詹姆斯·J·亨特博士解释道：
“软件和人工智能的数字化转型正在推动OTA更新的需求——这两者都需要解决方案提供商重新思考整个DevOps周期”[7]
关键安全层包括：
| 安全层 | 实施 | 目的 |
|---|---|---|
| 加密 | TLS与CA签名证书 | 在传输过程中保护更新包 |
| 身份验证 | 基于硬件的安全密钥 | 比基于文件的密钥提供更强大的保护 |
| 完整性验证 | 加密签名 | 确认更新的真实性 |
| 回滚保护 | 自动fallback机制 | 防止设备在更新失败时被砍砍 |
增强更新安全性的步骤:
-
建立安全连接
使用 TLS 进行主机名验证和 CA 签名证书，以确保服务器连接被验证[5]. -
保护更新包
对更新进行加密，并在加密后应用数字签名。为了最大程度地提高安全性，请使用空气隔离系统进行数字签名[5][6]. -
实施恢复机制
启用自动回滚功能，以有效处理更新失败[6].
Dr. Hunt 强调了在先进技术中的 OTA 更新的重要性：
“OTA 已经成为使自动驾驶系统可信赖的关键因素” - aicas 创始人、CEO 和 CTO Dr. James J. Hunt[7]
UNECE 批准了 UN 规范（UN R155/R156），该规范为各行业提供了安全 OTA 更新的框架。这些标准确保更新是安全的和可靠的
OTA 更新软件选项
选择正确的 OTA 更新软件不仅是安全措施，而且是确保顺利部署、有效版本控制和流畅的发布周期的关键 - Capacitor 应用。正确的工具使更新管理更简单和更高效。
Capgo: 远程更新平台
Capgo 已成功交付 482.9亿次更新 遍布 1,800个应用, 大幅提高发布效率 81% [1]以下是其独特之处：
-
安全性: 支持端到端加密和 code-签名验证，确保更新安全
-
集成: 与 CI/CD 平台如 Azure DevOps, GitLab, GitHub, Jenkins, Cloudbees, 和 Travis.
-
目录给安全常用给网络安全为等纫给安全。给网络给网络给网络。安全给网络给网络给网络。
-
一个安全的例存。目录给安全常用给网络安全为等纫给安全。
给网络给网络给网络。安全给网络给网络给网络。 科伦索 成功地在几分钟内接触到了其 5,000+ 用户 的几乎所有用户 [1]。 罗德里戈·曼蒂卡分享了:
“We practice agile development and @Capgo is mission-critical in delivering continuously to our users!” [1]
Alternative Update Tools
While Capgo offers a robust solution, other tools bring different approaches to version management. Here’s a quick comparison:
| Tool Aspect | Capgo | Appflow |
|---|---|---|
| Cost Structure | ~$300/month for CI/CD costs | $6,000 annual subscription |
| 更新策略 | 即刻部署，用户分配 | 后台，始终最新，强制更新 |
| 集成 | 多个CI/CD平台 | 内置CI/CD |
用户分享了他们的经历：
“我们目前正在尝试使用@Capgo，因为Appcenter停止了对混合应用程序的实时更新支持，而@AppFlow的价格太高了。” [1]
选择OTA更新工具时，务必注意以下功能：
~$300/month for CI/CD costs
-
端到端加密 以确保更新安全
-
CI/CD 集成 以适应您的工作流
-
用户分配 用于控制发布
-
应用商店合规 以避免发布问题 [10]
__CAPGO_KEEP_0__
结论
摘要
平衡技术精确度与用户体验可以改善OTA 更新管理 效率提高81% [1]. 这种方法支持有效的版本控制和可靠的OTA部署。
以下是成功OTA更新的主要注意事项:
下一步
为了提高OTA更新的流程，考虑以下行动:
-
选择合适的工具
根据讨论的策略，选择符合您的安全需求、部署目标和预算的工具。 -
遵循最佳实践
“Users might also be reluctant to run an OTA update as it disrupts their familiar and comfortable experience with the app, requiring them to get familiar with the more technical aspects of the product, that they are usually not familiar with.” [11]
-
跟踪和改进
监控您的更新的性能以及用户对它们的反应。使用这些数据来不断改进您的部署方法。
未来的OTA更新应该努力结合快速部署和smooth用户体验，确保两者都高效且满意。
