跳到主要内容
版本：v6

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 平台进行配置。

各平台的配置方法请参考：

已知不兼容插件​

执行 npx cap sync 时会自动跳过已知存在冲突或导致构建问题的插件。

以下是不兼容插件列表：

Contents

编辑此页