Capacitor 应用指南
什么是 Capacitor 应用?
Capacitor 应用是一种在真实的原生 iOS 和 Android 项目中部署的 web 应用。您的界面是运行在 WebView 中的 HTML、CSS 和 JavaScript，而 Capacitor 插件则将该 web code 与 native 设备 API 相连，如相机、存储、推送通知、生物识别、文件和位置。Capgo 将该架构转化为发布优势，包括实时更新、维护插件和native 云构建。
如何工作
Capacitor 不是 UI 框架。它是应用的native 运行时。Ionic、React、Vue、Angular、Svelte、Tailwind 或您的自定义设计系统可以在 WebView 内渲染 UI。
1. Web app
您使用常规的Web工具构建产品，然后输出静态资产。Capgo可以在审批后更新这些资产。
2. Native shell
Capacitor将这些资产放入iOS和Android项目中。Capgo Build在那些二进制文件必须重建时会提供帮助。
3. Plugin bridge
JavaScript调用插件，插件调用Swift、Kotlin、Java、Objective-C或web回退。Capgo维护了常见的native需求的插件。
Positive parts
- 一个Web代码库可以将产品部署到iOS、Android和Web上。
- 通过Capgo的实时更新，允许的HTML、CSS和JavaScript修复可以在native app获得批准后绕过商店审查队列。
- 团队可以保留React、Vue、Angular、Svelte或普通Web工具，而不必重写为Swift和Kotlin。
- native访问通过插件实现，且自定义的Swift、Kotlin、Java或Objective-Ccode仍然可以添加。
- 现有的现代Web应用可以采用Capacitor而无需改变UI框架。
- Capacitor 保持原生 iOS 和 Android 项目在仓库中，使得平台调试和 SDK 更加明确。
- 大多数 Cordova 插件仍然可以工作，这有助于老旧的 Ionic 和 Cordova 团队逐渐迁移。
- Capgo 在原生 Capacitor 插件、实时更新通道、回滚和云构建的基础上添加了 Capacitor 运行时。
负面部分
- UI 运行在 WebView 中，因此网页性能差劲会导致移动性能差劲。
- JavaScript 到原生桥接的数据传输会增加额外负担，尤其是大数据或频繁传输。
- 团队仍然需要一些原生应用知识来进行签名、商店审核、权限、Gradle、Xcode 和 SDK 升级。
- 原生项目是源文件，因此重大升级可能需要小心的手动修改。
- 插件生态系统很广泛，但并不是每个社区插件都有相同的维护质量，这就是为什么维护的 Capgo 插件对于生产应用很重要。
- 通常来说，不是最佳选择用于完全原生 UI、先进游戏、AR 重点应用或应用中有常见低延迟原生数据流。
最佳选择、不合适
Capacitor 最适合于
- SaaS、金融科技、医疗、教育、市场和内部工具，具有强大的Web产品需求。
- 现有的Web应用需要在不进行全native重写的情况下进行app-store分发。
- 希望Web、iOS和Android由同一前端团队处理的团队。
- 具有正常native需求的应用：摄像头、推送、认证、文件、生物识别、支付、位置和深度链接。
- 产品可以从商店批准后立即获得实时Web包更新。
- 希望Capgo Build处理可重复的iOS和Android构建、签名和发布工件，而不需要维护每个native CI细节的团队。
选择另一个堆栈时
- 高端3D游戏、视频编辑器、AR优先产品或依赖重型实时native渲染的应用。
- 希望只编写Swift、Kotlin、Java或Dart的团队。
- 每个屏幕都必须从原始平台控件构建的产品。
- 依赖于一个特殊nativeSDK的应用，但没有维护的插件存在，团队无法维护一个。
- 期望native-code、权限、特权或商店政策变化可以绕过应用审核的团队。 Capgo实时更新适用于Web包，而不是native二进制变化。
为什么Capgo很重要
原生应用等待新二进制文件、签名、发布和应用审查的每个可见变化。Capacitor为您提供一个在原生应用中的Web包。Capgo将该包转换为更快的发布路径，同时仍然保留原生code的更改以适应适当的应用商店审查流程。
跳过审查队列的实时更新
Capgo将允许的Web包更改直接发送给用户，直到原生应用获得批准，例如修复副本、UI修复、JavaScript补丁和远程配置不需要等待App Store或Play Store审查几天。
回滚、通道和控制发布
Capgo允许团队发布给beta用户、百分比、通道或特定版本，然后快速回滚当Web更新时有问题。
维护Capacitor插件
Capgo保持一个大型插件目录用于生产Capacitor应用，涵盖常见的原生需求，如身份验证、存储、购买、媒体、设备API和企业迁移。
原生Capgo构建
当原生code发生真正的变化时，Capgo Build会帮助生成iOS和Android构建、管理签名、跟踪日志并从同一个Capacitor项目中发送商店准备的工件。
__CAPGO_KEEP_0__源自Ionic团队，同样是Ionic框架的背后公司。它继承了Cordova和PhoneGap的核心WebView和native-plugin模式，但 在__CAPGO_KEEP_1__包、TypeScript、Swift、Kotlin、已提交的本机项目和PWA支持方面现代化了开发人员的体验。
Capacitor came from the Ionic team, the same company behind Ionic Framework. It inherits the core WebView and native-plugin pattern from Cordova and PhoneGap, but modernizes the developer experience around npm packages, TypeScript, Swift, Kotlin, committed native projects, and PWA support.
__CAPGO_KEEP_0__继承了混合应用的想法：一个本机壳、一个WebView和从JavaScript到本机API的桥梁。
Capacitor inherits the hybrid-app idea: a native shell, a WebView, and a bridge from JavaScript to native APIs.
Ionic团队开始探索Cordova的现代替代品，因为Ionic扩展到了不仅仅是移动UI。
__CAPGO_KEEP_0__首次发布于Ionic向iOS、Android、桌面和PWA的Web本机运行时迁移的过程中。
2019
Ionic加入了OutSystems。Ionic后来表示Capacitor仍然是OutSystems移动工作和开源支持的核心部分。
2022
Ionic将Capacitor转移到了更可预测的发布频率，并开始了公共背后健康重置。
2023-2026
Ionic moved Capacitor to a more predictable release cadence and began a public backlog health reset.
__CAPGO_KEEP_0__由Ionic团队维护，社区贡献者围绕着生态系统。该项目健康，但不是完美：Ionic公开承认了2026年2月的背后债务，并开始清理旧问题和拉取请求。
Capacitor is maintained by the Ionic team, with community contributors around the ecosystem. The project is healthy, but not perfect: Ionic publicly acknowledged backlog debt in February 2026 and started a cleanup process for old issues and pull requests.
__CAPGO_KEEP_0__来自Ionic团队，同样是Ionic框架的背后公司。它继承了Cordova和PhoneGap的核心WebView和native-plugin模式，但 在__CAPGO_KEEP_1__包、TypeScript、Swift、Kotlin、已提交的本机项目和PWA支持方面现代化了开发人员的体验。
最新稳定版本
8.3.1
发布于 2026 年 4 月 16 日
GitHub 个星星
15.6k
ionic-team/capacitor
分叉
1.2k
公开的 GitHub 仓库
每月下载
9.6M
@capacitor/core, 2026 年 4 月 6 日 - 5 月 5 日
实用阅读
当您的产品是web优先且移动应用很重要时，Capacitor作为一个强大的默认值。使用Capgo时，发布速度很重要：web修复的实时更新、回滚坏的发布、渠道进行阶段性发布、维护的插件为原生功能、Capgo Build当一个真正的原生二进制文件必须生成时。原生应用程序不获取实时更新路径；每个修复都等待一个新的构建和商店审查。
从Capacitor应用指南继续前进
如果您正在将Web应用转换为Capacitor应用，请连接此页面 Capgo快速入门 获取实时更新 Capgo插件目录 获取本机功能 Capgo本机构建 获取应用二进制文件 Capgo 实时更新 为 post-review 修复和 使用 Next.js 和 Capacitor 构建原生移动应用 为框架特定路径