Capacitor app 指南
Capacitor app 是什么?
Capacitor app 是一种在真实的 iOS 和 Android 项目中部署的 web app。您的界面是运行在 WebView 中的 HTML、CSS 和 JavaScript，而 Capacitor 插件则将该 web code 与 native 设备 API 相连，如相机、存储、推送通知、生物识别、文件和位置。 Capgo 将该架构转化为发布优势，包括实时更新、维护的插件和 native 云构建。
如何工作
Capacitor 不是 UI 框架。它是 app 下的 native 运行时。Ionic、React、Vue、Angular、Svelte、Tailwind 或您的设计系统可以在 WebView 内渲染 UI。
1. Web app
您使用正常的 web 工具构建产品，然后输出静态资产。 Capgo 可以在审批后更新这些资产。
2. Native shell
Capacitor 将这些资产放入 iOS 和 Android 项目中。 Capgo Build 可以帮助在这些二进制文件必须重建时。
3. 插件桥接
JavaScript 调用插件，插件调用 Swift、Kotlin、Java、Objective-C 或 web fallbacks。Capgo 维护常见的原生需求的插件。
积极方面
- 一个 web 代码库可以将产品发布到 iOS、Android 和 web 上。
- 通过 Capgo 的实时更新，允许的 HTML、CSS 和 JavaScript 修复可以绕过商店审查队列，等待原生应用被批准后。
- 团队可以保留 React、Vue、Angular、Svelte 或普通 web 工具，而不必重写为 Swift 和 Kotlin。
- 原生访问通过插件实现，自定义的 Swift、Kotlin、Java 或 Objective-C code 仍然可以添加。
- 现有的现代 web 应用可以采用 Capacitor 而不改变 UI 框架。
- Capacitor 保留原生 iOS 和 Android 项目在仓库中，这使得平台调试和 SDK 工作更加明确。
- 大多数 Cordova 插件仍然可以工作，这有助于更老的 Ionic 和 Cordova 团队逐渐迁移。
- Capgo 添加维护的 Capacitor 插件、实时更新通道、回滚和云构建，基于 Capacitor 运行时。
消极方面
- The UI runs in a WebView, so poor web performance becomes poor mobile performance.
- Large or frequent data transfers across the JavaScript-to-native bridge add overhead.
- Teams still need some native app knowledge for signing, store review, permissions, Gradle, Xcode, and SDK upgrades.
- Native projects are source files, so major upgrades can require careful manual changes.
- The plugin ecosystem is broad, but not every community plugin has the same maintenance quality, which is why maintained Capgo plugins matter for production apps.
- It is usually not the best fit for fully native UI, advanced games, AR-heavy apps, or apps with constant low-latency native data flows.
最佳适用场景、不适用场景
Capacitor 最适合在
- SaaS、金融科技、医疗、教育、市场平台和内部工具，强调web产品需求
- 现有web应用需要在app商店中发布，避免进行全native重写
- 希望web、iOS和Android大部分由同一前端团队处理的团队
- 普通native需求的应用：摄像头、推送、认证、文件、指纹识别、支付、定位和深度链接
- 产品可以在商店批准后立即获得实时的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补丁和远程配置就可以发布。
回滚、频道和控制发布
Capgo允许团队将应用程序发布到beta用户、百分比、频道或特定版本，然后快速回滚当web更新出现问题时。
维护Capacitor插件
Capgo为生产Capacitor应用程序提供了一个庞大的插件目录，涵盖了常见的本机需求，如身份验证、存储、购买、媒体、设备API和企业迁移。
Capgo构建本机发布
当本机code发生重大变化时，Capgo Build会帮助生成iOS和Android构建、管理签名、跟踪日志并从同一个Capacitor项目中发送商店准备的艺术品。
历史和血统
Capacitor来自Ionic团队，同样是Ionic框架背后的公司。它继承了Cordova和PhoneGap的核心WebView和本机插件模式，但 在开发人员体验方面现代化了npm包、TypeScript、Swift、Kotlin、承诺的本机项目和PWA支持。
Cordova和PhoneGap
Capacitor继承了混合应用的概念：一个本机壳、一个WebView和一个从JavaScript到本机API的桥梁。
2017年晚期
Ionic团队开始探索Cordova的现代替代品，因为Ionic扩展到仅限移动UI之外。
2019
Capacitor最初以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日
实用阅读
当您的产品是web优先且移动重要时，建议将 Capacitor 当作强大的默认值。使用 Capgo 时，发布速度更重要：web修复的实时更新、回滚坏的发布、分段发布、维护的原生插件和 Capgo Build 当需要生成真正的原生二进制文件时。仅原生应用程序不支持实时更新路径；每个修复都等待新建和商店审查的发布。
继续从 Capacitor 应用指南
如果您要将 Web 应用转换为 Capacitor 应用，请连接此页面 Capgo 快速入门 实时更新 Capgo 插件目录 原生功能 Capgo 原生构建 应用二进制文件 Capgo 实时更新 审查后修复和 使用 Next.js 和 Capacitor 构建原生移动应用 框架特定路径