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