Capacitor 应用指南
什么是 Capacitor 应用?
Capacitor 应用是一种在真实的 iOS 和 Android 项目中内置的 Web 应用。您的界面是运行在 WebView 中的 HTML、CSS 和 JavaScript，而 Capacitor 插件则将 Web code 与 native 设备 API（如相机、存储、推送通知、生物识别、文件和位置）进行了桥接。 Capgo 将这种架构转化为发布优势，包括实时更新、维护的插件和 native 云构建。
来自 Martin 的人性化支持
如何工作
Capacitor 不是 UI 框架。它是应用的 native 运行时。Ionic、React、Vue、Angular、Svelte、Tailwind 或您的自定义设计系统可以在 WebView 内渲染 UI。
1. Web 应用
您使用常规的Web工具构建产品，然后输出静态资产。Capgo可以在审批后更新这些资产。
2. 原生shell
Capacitor将这些资产放入iOS和Android项目中。Capgo Build在那些二进制文件必须重建时会提供帮助。
3. 插件桥接
JavaScript调用插件，而插件则调用Swift、Kotlin、Java、Objective-C或Web回退。Capgo维护了常见的原生需求的插件。
积极的部分
- 一个Web代码库可以将产品部署到iOS、Android和Web上。
- 通过Capgo的实时更新，允许的HTML、CSS和JavaScript修复可以在原生应用获得批准后绕过商店审查队列。
- 团队可以保留React、Vue、Angular、Svelte或普通Web工具，而不必重写为Swift和Kotlin。
- 原生访问通过插件实现，且可以添加自定义的Swift、Kotlin、Java或Objective-Ccode。
- 现有的现代Web应用可以采用Capacitor而无需改变UI框架。
- Capacitor会在仓库中保留原生iOS和Android项目，这使得平台调试和SDK工作更加明确。
- 大多数Cordova插件仍然可以正常工作，这有助于更老的Ionic和Cordova团队逐渐迁移。
- Capgo添加了维护的Capacitor插件、实时更新频道、回滚和基于Capacitor运行时的云构建。
负面部分
- UI在WebView中运行，因此Web性能差会导致移动性能差。
- JavaScript到本机桥之间的大型或频繁数据传输会增加开销。
- 团队仍然需要一些本机应用知识来进行签名、商店审核、权限、Gradle、Xcode和SDK升级。
- 本机项目是源文件，因此重大升级可能需要小心的手动更改。
- 插件生态系统很广泛，但并不是每个社区插件都有相同的维护质量，这就是为什么维护的Capgo插件对于生产应用很重要的原因。
- 通常不适合完全本机UI、高级游戏、AR重APP或常有低延迟本机数据流的应用。
最佳适配、不适合
Capacitor最适合在
- 软件即服务、金融科技、医疗保健、教育、市场和内部工具中，强调Web产品需求。
- 现有需要在应用商店中发布的Web应用，避免进行全面原生重写。
- 希望同一前端团队处理Web、iOS和Android的团队。
- 具有正常原生需求的应用：摄像头、推送、身份验证、文件、生物识别、支付、位置和深度链接。
- 受益于在商店批准后进行实时Web包更新的产品。
- 希望Capgo Build处理可重复的iOS和Android构建、签名和发布工件，而无需维护每个原生CI细节的团队。
选择另一个堆栈时
- 高端3D游戏、视频编辑器、AR首先产品或依赖重型实时原生渲染的应用。
- 希望编写Swift、Kotlin、Java或Dart的团队。
- 每个屏幕都必须使用原始平台原生控件构建的产品。
- 依赖于一个特定原生的SDK的应用，但没有维护的插件存在且团队无法维护一个。
- 期望原生code、权限、特权或商店政策变化可以绕过应用审核的团队。Capgo实时更新适用于Web包，而不是原生二进制变化。
为什么Capgo很重要
原生应用等待每个可见变化的新二进制文件、签名、发布和应用程序审查。 Capacitor 给你一个在原生应用内部的 Web 包。 Capgo 将该包转换为一个更快的发布路径，同时仍然保留原生-code 的更改在适当的应用商店审查流程中。
跳过审查队列的实时更新
Capgo 直接将允许的 Web 包更改发送给用户，等待原生应用审批后，复制修复、UI 修复、JavaScript 补丁和远程配置不需要等待 App Store 或 Play Store 审核。
回滚、渠道和控制发布
Capgo 允许团队发布给 beta 用户、百分比、渠道或特定版本，然后快速回滚，当 Web 更新出现问题时。
维护的 Capacitor 插件
Capgo keeps a large plugin catalog for production Capacitor apps, covering common native needs such as auth, storage, purchases, media, device APIs, and enterprise migrations.
Capgo 为生产 __CAPGO_KEEP_1__ 应用程序保留一个大型插件目录，涵盖常见的原生需求，如身份验证、存储、购买、媒体、设备 API 和企业迁移。
When native code really changes, Capgo Build helps produce iOS and Android builds, manage signing, follow logs, and ship store-ready artifacts from the same Capacitor project.
当原生 __CAPGO_KEEP_0__ 真正改变时，__CAPGO_KEEP_1__ 构建帮助产生 iOS 和 Android 构建、管理签名、跟踪日志并从同一个 __CAPGO_KEEP_2__ 项目中发送商店准备的艺术品。
历史和血统
Capacitor来自Ionic团队，同样是Ionic框架的背后公司。它继承了Cordova和PhoneGap的核心WebView和原生插件模式，但 在npm包，TypeScript，Swift，Kotlin，已提交的原生项目和PWA支持方面现代化了开发人员的体验。
Cordova和PhoneGap
Capacitor继承了混合应用的想法：一个原生壳，一个WebView，以及从JavaScript到原生API的桥梁。
2017年后期
Ionic团队开始探索Cordova的现代替代品，因为Ionic扩展到了仅仅是移动UI之外的领域。
2019
Capacitor最初作为Ionic向iOS，Android，桌面和PWA的Web原生运行时迁移而发布。
2022
Ionic加入了OutSystems。Ionic后来表示Capacitor仍然是OutSystems移动工作和开源支持的核心。
2023-2026
Ionic将Capacitor转移到了更可预测的发布频率，并开始了公共背调健康重置。
维护和健康
Capacitor由Ionic团队维护，社区贡献者围绕着生态系统。该项目健康，但不是完美的：Ionic在2026年2月公开承认了背调债务，并开始了清理旧问题和拉取请求的过程。
截至2026年5月6日。计数随时间而变化。
最新稳定版本
8.3.1
发布于 2026 年 4 月 16 日
GitHub 个星星
15.6k
ionic-team/capacitor
分支
1.2k
公开 GitHub 仓库
月度下载
9.6M
@capacitor/core, 2026 年 4 月 6 日至 5 月 5 日
实用阅读
以 Capacitor 作为强大的默认值，当您的产品是 web-first 且移动应用很重要时。使用 Capgo 时，发布速度很重要：web 修复的实时更新、回滚的坏发布、分阶段的发布、维护的原生插件和 Capgo Build 当必须产生真正的原生二进制文件时。原生应用不再有实时更新的路径；每个修复都等待一个新的构建和商店审查。
从Capacitor App 指南继续前进
如果您正在将 Web 应用转换为Capacitor应用，请将此页面连接到 Capgo快速入门 实时更新 Capgo插件目录 原生功能 Capgo原生构建 应用二进制文件 Capgo 实时更新 为 post-review 修复，和 使用 Next.js 和 Capacitor 构建一个原生移动应用 底部