版本：v6

将 Capacitor 与 Ionic Framework 一起使用

Capacitor 不要求使用 Ionic Framework 来构建应用。但是，开发者可能会发现 Ionic UI 组件的大型集合有助于构建高质量的应用。

Capacitor 可以通过使用 Ionic CLI 直接快速安装到任何新的或现有的 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 一起使用，您可以查看此处的文档。