概览

本快速入门教程将带你了解 Capgo 的核心概念！我们将探讨的概念包括：

1. 在您的 Capgo 账号中添加应用

2. 将 Capgo 集成到您的 CI/CD 中

3. 通过推送 commit 在 Capgo 上触发 bundle 上传

4. 配置并自定义 Capgo 的 bundle 发布

5. 配置应用以通过 Capgo 启用 Live Updates

6. 通过 Capgo 向应用部署 Live Updates

您可以按步骤跟随指南，也可以直接前往感兴趣组件的文档。

开始教程

跟着快速入门教程，很快就能上手 Capgo！

CLI 入门指南

交互式 CLI onboarding 流程的完整分步指南。

发布更新

通过 Capgo dashboard 向你的 App 发布更新。

自动更新

将 Capgo 集成到你的 CI/CD 中，通过推送 commit 在 Capgo 上触发 bundle 上传。

故障排除

常见问题及解决方案。

总结

总结本教程，并快速回顾你学到的内容。

提示

Over-the-Air (OTA) 更新功能仅适用于对 HTML、CSS 和 JavaScript 文件的修改。

如果你对原生 code 做了任何更改（例如更新 Capacitor 插件），就必须重新提交应用到 App Store 审核。

Bundle 机密性

除非您启用了 Capgo 加密，否则上传到 Capgo 的每个 bundle 都应被视为公开的 Web 资源。私有 Channel 可以控制哪些设备有权接收更新，但并不能保证上传的 bundle 是保密的。加密技术可以保护传输路径，防止第三方生成有效的加密更新，但由于公钥已分发在二进制文件中，只要投入足够的精力，仍然可以从 App 中对已发布的 Web 资源进行逆向工程。详情请参阅 Live Update 加密.

加入 Discord 社区

加入 Capgo Discord 服务器！

维护

插件版本	Capacitor 兼容性	已维护
v7.*.* (≥7.25.0)	v7.*.*	✅ 完全支持
v6.*.* (≥6.25.0)	v6.*.*	✅ 完全支持
v5.*.* (≥5.10.0)	v5.*.*	✅ 完全支持
v5.*.* (<5.10.0)	v5.*.*	⚠️ 已弃用
v4.*.*	v4.*.*	❌ 已不再支持
v3.*.*	v3.*.*	❌ 已不再支持
>= 8	v4.*.*	⚠️ 因 CI 流程版本问题已弃用

符合应用商店指南

Android Google Play 和 iOS App Store 都有相应的指南，在您的应用中集成 Capacitor-updater 方案之前，请务必了解其中的规则。

Google Play

第 3 段关于 设备和网络滥用 主题的内容描述了：通过 Google Play 更新机制以外的任何方法更新源 code 都是受限的。但此限制不适用于更新 JavaScript bundle。

此限制不适用于在虚拟机中运行且对 Android API 访问受限的 code（例如 WebView 或浏览器中的 JavaScript）。

这完全允许使用 Capacitor-updater，因为它只更新 JS bundle，不会更新原生 code。

App Store

段落 3.3.2，自 2015 年的 Apple Developer Program 许可协议 完全允许对 JavaScript 和 assets 进行 OTA 更新——并且在其最新版本（20170605）中 在此下载 这项规定甚至更为广泛：

解释型 code 可被下载到 App 中，但前提是该 code：(a) 不得通过提供与提交至 App Store 时预期及宣传目的不符的功能或特性，改变 App 的主要用途；(b) 不得为其他 code 或 App 创建商店或店面；(c) 不得绕过操作系统的签名、sandbox 或其他安全特性。

Capacitor Updater 允许您在完全合规的前提下遵循这些规则，只要您推送的更新不会使您的产品显著偏离最初在 App Store 获批的预期用途。

为了进一步符合 Apple 的指南，我们建议通过 App Store 分发的应用不要启用 Force update 场景，因为在 App Store 审核指南 中规定：

应用不得强制用户进行评分、评论、下载其他应用或执行类似操作，以换取访问功能、内容或使用应用的机会。

这对于后台更新的默认行为来说不是问题，因为它不会强制用户立即应用新版本，直到用户下次关闭应用时；但如果您决定展示该功能，至少应该意识到其潜在影响。

开源

该插件采用 LGPL-3.0 许可，后端采用 AGPL-3.0 许可。

💡 LGPL-3.0 意味着如果有人修改了该插件的 code，则必须以相同的开源许可协议发布。如果你在不修改的情况下使用 code，则不受此限制。详情请查看下方链接 👇

许可协议？

与其阅读文档，不如尝试使用 GPTS Capgo 获取帮助

你可以放心将其集成到应用中

结语

如果您选择自托管并觉得此工具对您有所帮助，请考虑通过成为我们的赞助者来支持我的工作 GitHub 赞助者.

我赌了一把，把在这里构建的所有 code 都开源，而不是把它设为付费内容。我相信，通过开放而非对抗和隐藏，我们可以让世界变得更好。

为了实现这一目标，我们需要共同努力，也包括你 🥹。如果 Capgo cloud 无法满足你的需求，你可以 在 GitHub Sponsors 上支持独立开发者 以你喜欢的方式进行支持。

简单数学

基础版价格：$14*12 = $168/年。 而平均开发时薪 = $60。 这意味着，如果你在自托管上浪费了超过 3 小时的开发时间，这笔钱就够付一整年的费用了；如果超过 3 小时，你就是在亏钱 ^^

从概览继续

如果你正在使用 概览 规划 CI/CD 自动化，并将其与 Capgo CI/CD 用于 Capgo CI/CD 中的产品工作流， Capgo Native Build 用于 Capgo Native Builds 中的产品工作流， Capgo 集成 用于 Capgo 集成中的产品工作流， CI/CD 集成 了解 CI/CD 集成的实现细节，以及 GitHub Actions 集成 有关 GitHub Actions 集成的实现细节。