版本：v4

在 Ionic 框架中使用 Capacitor

Capacitor 构建应用并不依赖 Ionic 框架，但开发者可能会发现 Ionic 提供的丰富组件库能帮助构建更高质量的应用程序。

通过 Ionic CLI，可以快速将 Capacitor 安装到任何新建或已有的 Ionic 项目中。

在新 Ionic 项目中安装 Capacitor

对于新建的 Ionic 项目，Capacitor 已默认集成！您只需创建一个新项目即可。运行以下命令初始化 Ionic 项目：

ionic start

如需构建首个基于 Capacitor 的 Ionic 应用教程，请参考 Ionic 团队提供的入门指南。

若现有 Ionic 项目未启用 Capacitor，可运行以下命令进行集成：

ionic integrations enable capacitor

Ionic 框架使用了以下 Capacitor 插件的 API：

为获得最佳用户体验，即使未在代码中显式调用这些插件，也应确保它们已安装。在项目根目录下执行：

npm i @capacitor/app @capacitor/haptics @capacitor/keyboard @capacitor/status-bar

安装 Capacitor 及其插件后，可为应用添加移动平台支持：

ionic capacitor add android
ionic capacitor add ios

这将在项目根目录创建对应平台的原生工程目录。该目录应被视为源码产物，详情参阅原生项目管理。

信息

如果您的 Ionic 应用当前使用 Cordova，我们也提供了从 Cordova 迁移到 Capacitor 的指南。

Ionic CLI 封装了一系列便捷的 Capacitor 高级命令，具体文档如下。每个命令后添加 --help 参数可查看详细帮助：

关于 Ionic CLI 及其与 Capacitor 配合使用的更多信息，请参阅官方文档。