ionic-team/capacitor

这是什么？

核心功能

• 01用一套 Web 代码原生运行在 iOS、Android 和 Web 上。
• 02提供跨平台 API，可从 JavaScript 调用原生 SDK。
• 03提供插件 API，可用 Swift、Kotlin 或 Java 编写原生插件。
• 04原生工程作为可直接编辑的源码保存，而非构建产物。
• 05兼容大多数 Cordova 插件。

适用场景

• 将现有 Web 应用发布到 App Store 和 Google Play。
• 在 JavaScript 前端中调用设备原生功能。
• 编写可复用的原生插件并以 npm 包发布。
• 同时面向原生应用商店和移动端网页部署同一应用。

快速上手

1. 1

   在现有网页应用中安装核心包和命令行工具

   npm install @capacitor/core @capacitor/cli
2. 2

   在应用中初始化 Capacitor

   npx cap init
3. 3

   安装 Android 平台

   npm install @capacitor/android
4. 4

   添加 Android 原生项目

   npx cap add android

使用前须知

• !构建原生 iOS 应用需要带有 Xcode 的 Mac，README 未说明此设置。

标签

常见问题

capacitor 是什么？

Capacitor 是一个跨平台运行时，让 Web 应用用同一套代码原生运行在 iOS、Android 和 Web 上。 Capacitor 可以把现有的 Web 应用包装成原生应用，运行在 iOS、Android 和 Web 上。它提供跨平台 API 和代码执行层，让 Web 代码直接调用原生 SDK，同时支持用 Swift（iOS）或 Kotlin/Java（Android）编写自定义原生插件。

capacitor 可以免费使用吗？用的什么许可证？

capacitor 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

capacitor 还在维护吗？

活跃维护中。capacitor 最近一次提交是在 2026年10月21日。

capacitor 适合用来做什么？

将现有 Web 应用发布到 App Store 和 Google Play。 在 JavaScript 前端中调用设备原生功能。 编写可复用的原生插件并以 npm 包发布。 同时面向原生应用商店和移动端网页部署同一应用。

capacitor 怎么安装和运行？

在现有网页应用中安装核心包和命令行工具: npm install @capacitor/core @capacitor/cli 在应用中初始化 Capacitor: npx cap init 安装 Android 平台: npm install @capacitor/android 添加 Android 原生项目: npx cap add android

在哪里获取 capacitor？

源代码和安装说明在 GitHub 上：https://github.com/ionic-team/capacitor