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 最适合
- 软件即服务、金融科技、医疗保健、教育、市场平台和内部工具，强调了 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__ 项目中推送商店准备的 artifact。
使用 __CAPGO_KEEP_0__ 实时更新
构建原生发布版本的 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-native运行时迁移的第一步发布。
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 日
实用阅读
当您的产品是 web-first 且移动应用很重要时，请将 Capacitor 视为强大的默认值。使用 Capgo 时，发布速度很重要：为 web 修复提供实时更新、回滚为糟糕的发布、用于分阶段发布的通道、维护的插件用于本机功能，以及 Capgo Build 当需要生成真正的本机二进制文件时。仅有本机应用程序不具有实时更新的路径；每个修复都等待一个新的构建和商店审查。
继续阅读Capacitor App 指南
如果您要将 Web 应用转换为Capacitor应用，请将此页面连接到 Capgo快速入门 实时更新 Capgo插件目录 原生功能 Capgo原生构建 应用二进制 Capgo实时更新 修复和 使用 Next.js 和 Capacitor 构建原生移动应用 为特定框架的路径。