版本：v8

将 Capacitor 与 Ionic Framework 配合使用

构建应用时，Capacitor 并不要求使用 Ionic Framework。不过，开发者可能会发现 Ionic 的大量 UI 组件有助于构建高质量的应用。

通过使用 Ionic CLI，可以快速将 Capacitor 直接安装到任何新的或现有的 Ionic 应用中。

在新 Ionic 项目中安装 Capacitor

对于新的 Ionic 项目，Capacitor 已经默认安装在新的 Ionic 应用中！你只需要启动一个新项目即可。要创建一个新的 Ionic 项目，请运行以下命令：

ionic start

如果你需要构建第一个基于 Capacitor 的 Ionic 应用的教程，请查看由 Ionic Framework 团队编写的此教程。

如果你有一个尚未启用 Capacitor 的现有 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 CLI 进行了封装以便使用。请参阅以下每个命令的文档。在每个命令后使用 --help 标志也可以查看帮助输出。

有关 Ionic CLI 的更多信息，以及如何将其与 Capacitor 配合使用，你可以查看此处的文档。