版本：v7

在 Ionic Framework 中使用 Capacitor

构建应用时，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 的指南，详见从 Cordova 迁移到 Capacitor。

为方便起见，Ionic CLI 提供了一系列封装了 Capacitor CLI 的高级命令。请参阅以下各命令的文档。也可以通过在每个命令后使用 --help 标志来查看帮助信息。

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