capacitor

<br /> <div align="center"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/e299f665-383b-4318-a189-9230afb39ac0.png" width="560" /> </div> <div align="center"> ⚡️ 使用JavaScript和Web技术构建跨平台应用 ⚡️ </div> <br /> <p align="center"> <a href="https://github.com/ionic-team/capacitor/actions?query=workflow%3ACI"><img src="https://img.shields.io/github/actions/workflow/status/ionic-team/capacitor/ci.yml?style=flat-square" /></a> <a href="https://www.npmjs.com/package/@capacitor/core"><img src="https://img.shields.io/npm/dw/@capacitor/core?style=flat-square" /></a> <a href="https://www.npmjs.com/package/@capacitor/core"><img src="https://img.shields.io/npm/v/@capacitor/core?style=flat-square" /></a> <a href="https://www.npmjs.com/package/@capacitor/core"><img src="https://img.shields.io/npm/l/@capacitor/core?style=flat-square" /></a> </p> <p align="center"> <a href="https://capacitorjs.com/docs"><img src="https://img.shields.io/static/v1?label=docs&message=capacitorjs.com&color=blue&style=flat-square" /></a> <a href="https://twitter.com/capacitorjs"><img src="https://img.shields.io/twitter/follow/capacitorjs" /></a> </p>

---

Capacitor允许您使用单一代码库和跨平台API在iOS、Android、Web等平台上原生运行Web应用。

Capacitor提供了一个跨平台的API和代码执行层，使得从Web代码调用原生SDK以及编写应用可能需要的自定义原生插件变得简单。此外，Capacitor还提供了一流的渐进式Web应用支持，让您可以编写一次应用，然后同时部署到应用商店和移动网页。

Capacitor带有一个用于构建原生插件的Plugin 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

新应用？

对于新应用，我们推荐尝试使用Ionic Framework和Capacitor。

首先，安装Ionic CLI（npm install -g @ionic/cli）并启动一个新应用：

ionic start --capacitor

常见问题

Capacitor和Cordova有什么区别？

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

Capacitor和Cordova的区别在于Capacitor：

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

更多详情请参阅文档。

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

不，您不需要将Ionic Framework与Capacitor一起使用。如果不使用Ionic Framework，您可能需要自己实现原生UI。如果不使用Ionic CLI，您可能需要自己配置工具以启用诸如实时重载等功能。更多详情请参阅文档。

贡献

请参阅CONTRIBUTING.md。

贡献者

由Capacitor社区共同努力实现。 💖