跳到主要内容
版本:v4

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

兼容性问题

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

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

变量和钩子

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

请查阅 iOSAndroid 配置指南,了解如何配置每个平台。

已知不兼容的插件

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

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