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 上跳过）