Capgo 让你更新你的 Capacitor 应用即时更新，无需等待应用商店审核。它提供快速、安全且合规的 OTA 更新。以下是您需要了解的内容：
- 快速更新： 95% 的用户在 24 小时内收到更新，5MB 的 bundle 在 114ms 内交付。
- 轻松配置： 使用
npm install @capgo/capacitor-updater安装插件，同步项目，几分钟内即可配置更新。 - 安全合规： 端到端加密，并符合 Apple 和 Google 的规范。
- 灵活灰度发布： 将更新分配给特定用户组（例如 beta、production），实现可控发布。
- 错误处理： 实时追踪、回滚选项以及 部分更新 确保稳定性。
Capgo 专为无缝、轻量级部署而设计，让你专注优化应用，更新在后台完成。
快速入门 Capgo
在您的应用中启动并运行 Capgo Capacitor 项目 过程很简单。只需快速安装并进行一些基本配置即可。
系统要求
开始之前，请确保开发环境满足以下最低要求：
| 组成部分 | 最低配置要求 |
|---|---|
| Node.js | 最新 LTS 版本 |
| Capacitor | 3.0 或更高版本 |
| 平台工具 | Xcode 的 Mac （用于 iOS）或 Android Studio 中的错误日志 |
您还需要安装 Capacitor 开发所需的工具，例如 iOS 的 Xcode 或 Android 的 Android Studio。
插件安装步骤
以下是安装和配置 Capgo 的方法：
-
步骤 1：安装 Capgo 插件
运行以下命令以安装 Capgo updater 插件:
npm install @capgo/capacitor-updater -
步骤 2：同步您的项目
安装插件后，将其与您的 Capacitor 项目同步：
npx cap sync -
步骤 3：设置 Live Update
要启用 Live Update，请安装 Capgo CLI 并初始化它：
npm install @capgo/cli npx @capgo/cli init
设置完成后，即可开始配置项目，实现轻松更新。
基础配置
要在您的 Capacitor 项目中配置 Capgo，请更新 capacitor.config.ts 包含以下设置的文件：
{
plugins: {
CapacitorUpdater: {
autoUpdate: true,
updateUrl: 'https://api.capgo.app/updates'
}
}
}您可以根据项目需求微调这些设置。以下是可用选项的简要说明：
| 设置 | 用途 | 推荐值 |
|---|---|---|
| autoUpdate | 支持 自动更新 | true |
| updateUrl | 本指南中介绍的 更新端点 | https://api.capgo.app/updates |
完成这些配置后，你的项目就能高效处理 Live Update。
管理 OTA 更新
配置更新自动化
使用 Capgo 自动化更新可简化部署流程。先使用以下命令完成 CLI 访问认证：
npx @capgo/cli@latest init API_KEY接下来，运行以下命令从当前 code 创建更新 bundle：
npx @capgo/cli app update配置完成后，Capgo 会在应用启动时自动检查更新，在后台安装，并在下次重启时应用更改。
| 更新类型 | 时机 | 用户影响 |
|---|---|---|
| 后台检查 | 应用启动 | 无中断 |
| 手动触发 | 按需 | 干扰最小 |
| 推送通知 | 基于事件 | 用户控制 |
自动化更新后，您可以使用 Capgo 的 channel 系统 来为不同用户组自定义发布流程。
更新分发控制
Capgo 允许您将特定更新版本分配给不同渠道，从而灵活管理部署。以下是一个配置示例：
{
"channels": {
"beta": "v2.0.0-beta",
"production": "v1.9.5",
"enterprise": "v1.9.5-ent"
}
}此配置可确保部署井然有序，具体如下：
| 渠道 | 用途 | 更新频率 |
|---|---|---|
| Beta | 早期功能测试 | 每周 |
| 生产环境 | 稳定版本 | 双周 |
| 企业版 | 企业客户 | 每月 |
| 重度用户 | 性能更新 | 按需 |
通过将更新分配到特定渠道，您可以在向所有用户推送之前，先在小范围内测试新功能。
更新错误处理
一旦更新配置并分发完毕，Capgo 的错误管理功能有助于保持应用稳定性。这些功能包括：
- 实时追踪： 监控各设备上的更新进度。
- 强大的安全性： 确保更新安全且防篡改。
- 一键回滚： 如有需要，可快速回退到稳定版本。
- 增量更新： 仅下发修改过的文件以优化性能。
要有效管理错误，可以考虑使用以下工具：
| 功能 | 功能 | 实现 |
|---|---|---|
| 自动重试 | 解决网络问题 | 内置 Capgo 功能 |
| 版本控制 | 追踪更新来源 | Git 集成 |
| 错误日志 | 监控更新问题 | Dashboard 分析 |
| 回滚系统 | 恢复稳定版本 | 一条命令回滚 |
利用 Channel 系统进行渐进式发布，即使更新出现问题，也能降低风险并确保 App 保持稳定。
安全与 App Store 规则
更新加密系统
Capgo 使用以下方式保护其更新包 端到端加密，优先考虑关键安全特性以保障数据。其工作原理如下：
| 安全功能 | 实现 | 优势 |
|---|---|---|
| 端到端加密 | 安全方法 | 阻止未授权访问 |
| 密钥管理 | 硬件存储 | 保护加密密钥 |
| 访问控制 | 基于角色的权限控制 | 限制更新分发访问权限 |
这些措施，结合对平台安全指南的严格遵循，促成了令人印象深刻的 82% 全球成功率 在 750 多个生产应用中 [2].
平台指南
Capgo 确保完全符合 iOS 和 Android 应用商店的要求，遵循其关于应用安全与透明运营的具体规则。
对于 iOS 应用，开发者必须：
- 提供 清晰的应用内账号删除选项.
- 保持 透明的数据收集实践.
- 在实现 “Sign in with Apple” 时，使用 Apple 的 REST API 进行 token 撤销。
在 Android 端，Google Play 要求：
- 清除通知 针对待处理更新。
- 端到端加密 针对所有更新包。
- 详细 版本控制 以提高透明度。
通过遵循这些指南，Capgo 助力实现了 2350 万次成功更新 并保持合规性 [2]。此外，平台会主动监控更新性能，以确保持续改进。
更新追踪系统
为了配合其安全的更新分发，Capgo 的跟踪系统提供 实时监控 以优化性能并检测潜在问题。以下是详细说明：
| 监控环节 | 用途 | 成功指标 |
|---|---|---|
| 实时分析 | 追踪更新成功率 | 24 小时内 95% 的采用率 |
| 性能追踪 | 优化下载速度 | 提升响应时间 |
| 错误检测 | 快速识别问题 | 监控下载速度 |
| 版本管理 | 控制更新分发 | 追踪整体成功率 |
这套强大的追踪系统确保更新安全、高效，进一步体现了 Capgo 对可靠、无缝更新分发的承诺。
更新性能优化技巧
专注于性能优化，让更新保持顺畅、不中断。
减小更新包体积
Capgo 使用 delta 更新，只传输版本之间的变更。要进一步减小更新体积，可以考虑以下策略：
| 优化技术 | 影响 | 实现 |
|---|---|---|
| Code 代码压缩 | 缩小 code 体积 | 压缩 JavaScript、CSS 和 HTML 文件 |
| WebP 图像格式 | 减小图像文件大小 | 将静态图像转换为 WebP 格式 |
| 矢量图形 | 体积小且可缩放 | 用于图标和 Logo，替代位图 |
| 资源清理 | 消除不必要的资源 | 移除未使用的文件和资源 |
为获得最佳效果，请重点关注以下步骤：
- 将图像转换为 WebP 以获得更小的文件体积。
- 尽可能用 矢量图形 替代位图。
- 启用工具来压缩和精简您的 code。
- 定期清理未使用的资源和调试符号。
后台更新加载
通过后台加载更新来确保无缝体验。以下是提高效率的一些方法：
- 使用 Capacitor 的 Filesystem API 用于缓存和本地存储。
- 使用以下方式更高效地处理文件： blobs 而非 base64 字符串。
- 集成 懒加载 以缩短应用的初始加载时间。
这种方法可确保在后台应用更新的同时，用户依然能获得不间断的功能体验。
更新包体积管理
控制更新包的总大小与优化加载速度同样重要。保持合理的包体积能确保 App 运行流畅且高效。你可以通过以下方式实现：
- 定期检查并移除未使用的资源。
- 应用 App Thinning 用于减小 bundle 体积的 iOS 技术。
- 优化本地数据库，提升数据处理效率。
- 压缩图片资源以节省空间。
- 通过运行时自定义动态复用资源。
总结
Capgo 作为部署方面的可靠方案脱颖而出， Capacitor 应用其在超过 2,000 个生产级 App 中交付了逾 1.7 万亿次更新，成绩斐然 [1]. 这样的性能表现，凸显了它能轻松应对大规模真实环境部署。
该平台通过以下功能简化了部署流程：
- 端到端加密 用于安全交付更新
- 差分更新 最大限度降低带宽占用
- 无缝集成 CI/CD 与主流平台集成
- App Store 合规 支持 iOS 和 Android
- 一键回滚 实现快速版本控制
Capgo 集效率、安全性与合规性于一体，是寻求轻量高效部署方案的团队的绝佳选择。其功能丰富的平台在满足平台要求的同时，解决了现代应用部署中的诸多挑战。
想要简化应用的部署流程？立即开始使用 Capgo，优化更新流程并提升应用性能。
常见问题
::: 常见问题
Capgo 如何在提供 OTA 更新的同时，依然符合 Apple 和 Google 的指南要求？
Capgo 如何持续符合 App Store 指南
Capgo 通过严格遵循其更新策略，确保符合 Apple 和 Google 应用商店的所有指南。对于 Apple，更新仅限于 非可执行内容，而 Google 提供了更大的灵活性，但要求严格的安全措施。Capgo 通过实施 端到端加密、获取用户对更新的同意，并遵守各平台的具体规则来满足这些要求。
为确保一切顺利，Capgo 定期审计其更新系统并监控政策变化。这些努力保证了 OTA 更新 保持安全、无缝且完全合规，让开发者和用户对整个流程充满信心。 :::
::: 常见问题
使用 Capgo 的 channel 系统管理应用更新有哪些优势？它又是如何提高应用可靠性的？
Capgo 的 channel 系统支持 定向分发更新，为开发者提供了向特定用户群发布更新的灵活性。这种方式非常适合分阶段发布、Beta 测试或进行受控实验。通过从小规模群体开始，开发者可以及早发现并修复问题，从而提升应用的可靠性。
该系统的另一个优势是支持 快速回滚，如果出现任何问题，允许用户回退到稳定版本。结合实时更新，Capgo 确保修复和新功能即时触达用户——绕过应用商店审核流程的延迟——让应用保持流畅运行，让用户满意。 :::
::: 常见问题
开发者在其 Capacitor 应用中使用 Capgo 时，如何提升更新性能并减小更新包体积？
借助 Capgo 让更新更快、体积可控，开发者可以重点关注几项实用技巧：
- 利用差分更新：无需重新发送整个 App，只发送发生变化的部分。这种方式能大幅减小 更新体积.
- 使用高效压缩：采用以下压缩方法，例如 ZSTD ，以进一步缩小更新文件。
- 合理规划 code 结构：将 code 划分为更小的模块化部分，以加速并简化更新流程。
除此之外，还可以用工具追踪 App 性能，例如 Firebase 可以突出需要改进的地方。这有助于确保更新不仅体积更小，还能提升用户体验。通过这些步骤，开发者可以提供流畅的实时更新，同时保持应用的可靠性和高效性。 :::
继续使用 Capgo Plugin：为 Capacitor 应用提供轻量部署
如果你正在使用 Capgo 插件：Capacitor 应用的轻量部署 来规划安全与合规，请结合 加密 了解 Encryption 的实现细节， 合规性 了解合规部分的实现细节， Capgo 安全扫描器 了解 Capgo Security Scanner 的产品工作流， Capgo 安全 用于 Capgo 安全的产品工作流，以及 Capgo 信任中心 用于 Capgo 信任中心的产品工作流。
