Capacitor 应用程序指南
Capacitor 应用程序是什么?
一个 Capacitor 应用程序是部署在真实的原生 iOS 和 Android 项目中的 Web 应用程序。您的界面是运行在 WebView 中的 HTML、CSS 和 JavaScript，而 Capacitor 插件则将 Web code 与 native 设备 API（如相机、存储、推送通知、生物识别、文件和位置）进行了桥接。 Capgo 将这种架构转化为发布优势，包括实时更新、维护的插件和native 云构建。
如何工作
Capacitor 不是 UI 框架。它是应用程序下面的原生运行时。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 为常见的 native 需求维护插件。
Positive aspects
- 一个 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 插件、实时更新通道、回滚和云构建。
Negative aspects
- UI 运行在 WebView 中，因此 web 性能差劲会导致移动性能差劲。
- JavaScript 到原生桥接的数据传输会增加额外的开销，尤其是对于大型或频繁的数据传输。
- 团队仍然需要一些本地应用程序知识来签署、商店审查、权限、Gradle、Xcode和SDK升级。
- 本地项目是源文件，因此重大升级可能需要小心的手动更改。
- 插件生态系统很广泛，但并不是每个社区插件都有相同的维护质量，这就是为什么维护的Capgo插件对于生产应用程序很重要的原因。
- 通常情况下，不是最佳选择用于完全本地UI、先进游戏、AR重APP或应用程序的低延迟本地数据流。
最佳匹配、不良匹配
Capacitor最适合
- SaaS、金融科技、医疗保健、教育、市场和内部工具，强大的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 提供了一个大型的生产Capacitor应用的插件目录，涵盖了常见的原生需求，如认证、存储、购买、媒体、设备API和企业迁移。
Capgo 构建原生发布
当原生code发生重大变化时，Capgo Build 可以帮助生成 iOS 和 Android 的构建，管理签名，跟踪日志，并从同一个Capacitor项目中生成商店准备好的 artifact。
历史和血统
Capacitor 来自 Ionic 团队，他们也是 Ionic Framework 的背后公司。它继承了 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 stars
15.6k
ionic-team/capacitor
Forks
1.2k
公共 GitHub 仓库
每月下载
9.6M
@capacitor/core, 2026年4月6日-5月5日
实用阅读
当您的产品是web优先且移动重要时，建议将 Capacitor 作为强大的默认值。使用 Capgo 时，发布速度很重要：web修复的实时更新、坏版本的回滚、阶段发布的通道、维护的插件和native功能、以及 Capgo Build，当需要生成真正的native二进制文件时。仅native应用无法获得实时更新路径；每个修复都等待新建和商店审查的发布。
从 Capacitor App 指南继续
如果您正在将 Web 应用转换为 Capacitor 应用，请连接此页面 Capgo 快速入门 为实时更新 Capgo 插件目录 为原生能力 Capgo 原生构建 为应用二进制 Capgo 实时更新 为审查后修复，和 使用 Next.js 和 Capacitor 构建原生移动应用 为框架特定的路径