版本：v4

在 Ionic Framework 中使用 Capacitor

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

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

在新 Ionic 项目中安装 Capacitor

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

ionic start

如果你希望有一个构建首个基于 Capacitor 的 Ionic 应用的教程，可以参考 Ionic Framework 团队提供的这个教程。

如果你有一个尚未启用 Capacitor 的现有 Ionic 项目，可以通过运行以下命令来启用：

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 配合使用，可以查看此文档。