版本：v6

在 Ionic Framework 中使用 Capacitor

构建应用并不要求必须使用 Ionic Framework。然而，开发者可能会发现 Ionic 提供的丰富组件库有助于构建高质量的应用程序。

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

在新 Ionic 项目中安装 Capacitor

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

ionic start

如果您希望获得构建第一个基于 Capacitor 的 Ionic 应用的教程，请查看 Ionic Framework 团队提供的此教程。

如果您现有的 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 结合使用，请参阅此文档。