版本：v7

在 Ionic Framework 中使用 Capacitor

Capacitor 构建应用时并不强制依赖 Ionic Framework。但开发者会发现 Ionic 提供的丰富组件库能有效帮助构建高质量应用。

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

在新 Ionic 项目中安装 Capacitor

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

ionic start

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

若现有 Ionic 项目未启用 Capacitor，可通过以下命令激活：

ionic integrations enable capacitor

Ionic Framework 依赖以下 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 集成说明，请参阅官方文档。