跳过主要内容
Capgo logo

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 的人性化支持

Browse Capgo plugins 跳过 web 修复的审查
跨 iOS、web 框架和 Android 的移动应用开发

如何工作

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 calls plugins, and plugins call Swift, Kotlin, Java, Objective-C, or web fallbacks. Capgo maintains plugins for common native needs.

__CAPGO_KEEP_0__ 维护插件以满足常见的原生需求。

  • 积极部分
  • With Capgo live updates, allowed HTML, CSS, and JavaScript fixes can bypass the store review queue after the native app is approved.
  • 通过 __CAPGO_KEEP_0__ 的实时更新，允许的 HTML、CSS 和 JavaScript 修复可以绕过商店审查队列，等待原生应用批准。
  • Native access comes through plugins, and custom Swift, Kotlin, Java, or Objective-C code can still be added.
  • 原生访问通过插件实现，自定义的 Swift、Kotlin、Java 或 Objective-C Capacitor 还可以添加。
  • Capacitor keeps native iOS and Android projects in the repo, which makes platform debugging and SDK work more explicit.
  • __CAPGO_KEEP_0__ 保留原生 iOS 和 Android 项目在仓库中，这使得平台调试和 __CAPGO_KEEP_1__ 工作更加明确。
  • Capgo adds maintained Capacitor plugins, live-update channels, rollback, and cloud builds on top of the Capacitor runtime.

不良部分

  • 由于 UI 在 WebView 中运行，网页性能不佳会导致移动端性能不佳。
  • JavaScript 到原生桥梁上的大或频繁数据传输会增加额外负担。
  • 团队仍需要一些原生应用知识来进行签名、商店审核、权限、Gradle、Xcode 和 SDK 升级。
  • 原生项目是源文件，因此重大升级可能需要小心的手动更改。
  • 插件生态系统很广泛，但并不是每个社区插件都有相同的维护质量，这就是为什么维护的 Capgo 插件对于生产应用很重要的原因。
  • 通常不适合完全原生 UI、先进游戏、AR 重点应用或需要低延迟原生数据流的应用。

最佳适配、不适合

Capacitor 最适合

  • 软件即服务、金融科技、医疗保健、教育、市场平台和内部工具的强大网页产品需求。
  • 需要在不进行完全原生重写的情况下将现有网页应用发布到应用商店的团队。
  • 希望通过大部分相同的前端团队来处理 Web、iOS 和 Android 的团队。
  • 适用于普通原生需求的应用：摄像头、推送、认证、文件、生物识别、支付、位置和深度链接。
  • 在商店批准后，受益于实时Web包更新的产品。
  • Teams that want Capgo Build to handle repeatable iOS and Android builds, signing, and release artifacts without maintaining every native CI detail.

选择另一个堆栈时：

  • 高端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 构建、管理签名、跟踪日志并将商店准备好的 artifact 从同一个 __CAPGO_KEEP_2__ 项目中推送。

Use Capgo live updates 上下文：页面/区域：主页营销文本。角色：网站文本句子。见于：组件 HumanSupport.astro，组件 pricing/Plans.astro。消息键 `home_hero_human_support`（主页英雄人性化支持）。

使用 __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 原生运行时时。

2022

Ionic 加入了 OutSystems。后来，Ionic 表示 Capacitor 在 OutSystems 的移动工作和开源支持中仍然非常重要。

2023-2026

Capacitor 的发布频率变得更加可预测，开始了对公共 bug 列表的健康重置。

维护和健康

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 时，发布速度很重要：为网页修复提供实时更新、回滚坏的发布、用于分段发布的通道、维护的插件用于本机功能，以及 Capgo Build 当需要生成真正的本机二进制文件时。仅有本机应用程序无法获得实时更新路径；每个修复都等待一个新的构建和商店审查。

使用 Capgo 构建本机应用 使用 Capgo

源码

继续使用Capacitor App 指南

如果您正在将 Web 应用转换为Capacitor 应用，请将此页面连接到 Capgo 快速入门 实时更新 Capgo 插件目录 原生功能 Capgo 原生构建 应用二进制 Capgo 实时更新 实时更新 hero 标签（Live Update Hero Badge）,用于 live-update.astro 页面的导航或 UI 小标签。保留 Capgo 产品/品牌和开发者术语的原始形式。消息键 live_update_hero_badge。 使用 Next.js 和 Capacitor 构建原生移动应用 为特定框架的路径