Cordova 插件

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

安装 Cordova 插件

Capacitor 插件的安装方式与 Cordova 插件在 Capacitor 中的安装流程相同，都是通过包管理器安装后同步到原生项目中。

安装插件后执行同步操作，并完成必要的原生项目配置（参见变量与钩子）：

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

兼容性问题

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

如果发现现有 Cordova 插件存在问题，请通过提交 issue 提供问题详情和插件信息。

变量与钩子

由于 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 平台跳过）