Capacitor app guide
What is a Capacitor app?
A Capacitor app is a web app shipped inside real native iOS and Android projects. Your interface is HTML, CSS, and JavaScript running in a WebView, while Capacitor plugins bridge that web code to native device APIs like camera, storage, push notifications, biometrics, files, and location. Capgo turns that architecture into a release advantage with live updates, maintained plugins, and native cloud builds.
来自 Martin 的人性化支持
如何工作
Capacitor is not a UI framework. It is the native runtime under the app. Ionic, React, Vue, Angular, Svelte, Tailwind, or your own design system can render the UI inside the WebView.
1. Web 应用
You build the product with normal web tooling, then output static assets. Capgo can update those assets after approval.
2. Native 外壳
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 运行时。
不良部分
- 由于 UI 在 WebView 中运行，网页性能不佳会导致移动端性能不佳。
- JavaScript 到原生桥梁上的大或频繁数据传输会增加额外负担。
- 团队仍需要一些原生应用知识来进行签名、商店审核、权限、Gradle、Xcode 和 SDK 升级。
- 原生项目是源文件，因此重大升级可能需要小心的手动更改。
- 插件生态系统很广泛，但并不是每个社区插件都有相同的维护质量，这就是为什么维护的 Capgo 插件对于生产应用很重要的原因。
- 通常不适合完全原生 UI、先进游戏、AR 重点应用或需要低延迟原生数据流的应用。
最佳匹配、不佳匹配
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 构建会帮助生成 iOS 和 Android 构建、管理签名、跟踪日志并从同一个 Capacitor 项目中推送商店准备的构建文件。
来自 Martin 的人性化支持
历史和血统
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
Capacitor 的发布周期变得更加可预测，开始了一个公开的 backlog 健康重置过程。
维护和健康
Capacitor 由 Ionic 团队维护，社区贡献者在整个生态系统中贡献。该项目健康，但不是完美：Ionic 公开承认在 2026 年 2 月份的 backlog 债务，并开始清理旧问题和 pull 请求。
截至 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 视为强大的默认值。使用 Capgo 时，发布速度很重要：为 web 修复提供实时更新、回滚为糟糕的发布、通道为阶段性发布、维护的插件为原生功能、并且 Capgo Build 当需要生成真正的原生二进制文件时。原生应用程序不具有实时更新路径；每个修复都等待一个新的构建和商店审查。
继续使用Capacitor App 指南
如果您要将 Web 应用转换为Capacitor 应用，请将此页面连接到 Capgo 快速入门 实时更新 Capgo 插件目录 原生功能 Capgo 原生构建 应用二进制 Capgo 实时更新 修复和 使用 Next.js 和 Capacitor 构建原生移动应用 为特定框架的路径