capacitor

英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

Capacitor 让你可以使用单一代码库和跨平台 API 在 iOS、Android、Web 以及更多平台上本地运行 Web 应用。

Capacitor 提供跨平台 API 和代码执行层，使得从 Web 代码调用原生 SDK 以及编写应用可能需要的自定义原生插件变得容易。此外，Capacitor 提供一流的渐进式 Web 应用（PWA）支持，因此你可以编写一个应用并将其部署到应用商店和移动网页上。

Capacitor 附带用于构建原生插件的插件 API。插件可以在 Capacitor 应用中编写，或打包成 npm 依赖以供社区使用。插件作者被鼓励在 iOS 中使用 Swift 开发插件，在 Android 中使用 Kotlin（或 Java）开发插件。

入门

Capacitor 被设计成可以直接集成到任何现有的现代 web 应用中。在你的应用中运行以下命令来初始化 Capacitor：

npm install @capacitor/core @capacitor/cli
npx cap init

接下来，安装任何所需的本地平台：

npm install @capacitor/android
npx cap add android
npm install @capacitor/ios
npx cap add ios

新应用程序？

对于新应用程序，我们建议尝试使用带有 Capacitor 的 Ionic 框架。

首先，安装 Ionic CLI (npm install -g @ionic/cli) 并开始一个新应用程序：

ionic start --capacitor

常见问题

Capacitor 和 Cordova 之间有什么区别？

从本质上讲，Capacitor 和 Cordova 非常相似。Capacitor 提供与绝大多数 Cordova 插件的向后兼容性。

Capacitor 和 Cordova 的不同点在于 Capacitor：

• 采用了更现代的工具和插件开发方式
• 将原生项目视为源代码工件，而非构建工件
• 由 Ionic 团队维护 💙😊

更多详情请参见 文档。

我需要与 Capacitor 一起使用 Ionic Framework 吗？

不，使用 Capacitor 不需要使用 Ionic Framework。如果没有 Ionic Framework，您可能需要自己实现原生 UI。如果没有 Ionic CLI，您可能需要自己配置工具以启用诸如 livereload 等功能。更多详情请参见 文档。

贡献

Please refer to CONTRIBUTING.md.