Cordova 插件

在使用 Capacitor 开发应用时，可以使用 Cordova 插件。

安装 Cordova 插件

Capacitor 插件通过常规的包管理器安装，然后同步到原生项目中。在 Capacitor 中安装 Cordova 插件的过程与此相同。

安装插件、同步，然后完成任何必需的原生项目配置（请参阅 变量与钩子）：

npm install cordova-plugin-name
npx cap sync

如果 Cordova 插件有 @awesome-cordova-plugins 包装器，你也可以安装它以获得 TypeScript 支持：

npm install @awesome-cordova-plugins/plugin-name

更新 Cordova 插件

使用常规的包管理器更新插件。然后，将更新后的插件同步到原生项目中：

npm install cordova-plugin-name@version
npx cap sync

确定已安装的插件版本

要查看项目中安装的 Capacitor 和 Cordova 插件列表（及其精确版本号），请运行：

npx cap ls

兼容性问题

Capacitor 与某些 Cordova 插件之间可能存在兼容性问题。许多官方的 Cordova 插件不应使用，因为 Capacitor 提供了 官方替代方案。使用变量和钩子的 Cordova 插件可能部分兼容。有些 Cordova 插件则完全不兼容（请参阅 此列表）。

如果你发现现有 Cordova 插件存在问题，请通过提供问题详情和插件信息 告知我们。

变量与钩子

由于我们的理念是让你控制原生项目源代码（这意味着钩子之类的东西是不必要的），因此 Capacitor 不支持 Cordova 的安装变量、自动配置或钩子。如果你的插件需要设置变量或配置，你需要通过将插件的 plugin.xml 与 iOS 和 Android 上的所需设置进行映射，来手动应用这些配置设置。

请查阅 iOS 和 Android 配置指南，了解如何配置每个平台。

已知不兼容插件

如果已知某个插件存在冲突或导致构建问题，在运行 npx cap sync 时将会跳过该插件。

以下是已知不兼容插件的列表：

• cordova-plugin-add-swift-support（不需要，Capacitor 内置 Swift 支持）
• cordova-plugin-admobpro（详见）
• cordova-plugin-braintree（详见）
• cordova-plugin-code-push（详见）
• cordova-plugin-compat（不需要）
• cordova-plugin-console（不需要，Capacitor 有自己的实现）
• cordova-plugin-crosswalk-webview（Capacitor 不允许更改 WebView）
• cordova-plugin-fcm（详见）
• cordova-plugin-firebase（详见）
• cordova-plugin-ionic-keyboard（不需要，Capacitor 有自己的实现）
• cordova-plugin-ionic-webview（不需要，Capacitor 使用 WKWebView）
• cordova-plugin-music-controls（导致构建失败，已跳过）
• cordova-plugin-qrscanner（详见）
• cordova-plugin-splashscreen（不需要，Capacitor 有自己的实现）
• cordova-plugin-statusbar（不需要，Capacitor 有自己的实现）
• cordova-plugin-wkwebview-engine（不需要，Capacitor 使用 WKWebView）
• cordova-plugin-googlemaps（在 iOS 上导致构建失败，仅在 iOS 上跳过）