SuperAPI AI 工具集

capacitor-plugins

数据与分析

查看项目

更新于 10-15 17:31

技能介绍

用途:帮助在 Capacitor 应用中为某类原生能力选择合适插件、正确安装,并验证插件已在 iOS/Android 原生侧链接成功。适用于询问“某功能该用哪个插件”、需要原生能力(相机、文件、定位、生物识别、支付、认证、传感器、存储、媒体、日历、联系人、健康、端侧 LLM),或安装后出现插件未实现、UNIMPLEMENTED、找不到插件、OS-PLUG-* 错误码时。推送、启动图、键盘、深链、OTA 更新、插件升级迁移等应改用对应同级技能。

主要能力:

  • 优先推荐官方 @capacitor/* 包,若无或缺少所需功能则从 Capgo 参考索引用精确 @capgo/* 名称;
  • 给出匹配大版本的安装方式:npm install @capacitor/<name>,或 npm install @capacitor/camera@latest-7 这类标签;
  • 指导添加原生配置:iOS 用法说明键、Android 权限、variables.gradle、能力/权项、AppDelegate 挂钩;
  • 提供验证手段:npx cap sync(不得有 [error])、npx cap ls 查看已链接插件、检查 capacitor.build.gradle 与 Package.swift/Podfile;
  • 汇总常见错误及修复,如平台未实现、方法未实现、Android 找不到插件、iOS 加载插件失败、iOS 缺 NS*UsageDescription 导致崩溃、minSdk 冲突、peer 冲突等;
  • 运行时可用 Capacitor.isPluginAvailable('Camera') 与 Capacitor.getPlatform() 做能力探测。

使用方式(资料所述流程):先读取 package.json、capacitor.config.* 并确认 iOS 用 SPM 还是 CocoaPods,npx cap ls 查看现状;再选包、按匹配大版本安装并执行 npx cap sync;随后按参考补充原生配置——缺少 iOS 用法说明字符串会在首次访问时崩溃;提高 minSdkVersion、添加 HealthKit/推送权项或精确闹钟前需先询问用户;相机、健康、LLM、BLE、推送等应在真机运行验证;替换插件后用 grep 检查残留引用。版本方面:Capacitor 稳定 8.5.x,9 为 9.0.0-alpha,插件大版本须与应用 Capacitor 大版本一致;部分官方插件版本独立,应查看 npm view <pkg> peerDependencies;Capacitor 9 最低 iOS 16、Android minSdk 26。

限制:不能推荐参考文件中没有且未经 npm 核实的包名;同一原生表面不要装两个插件;Firebase 需逐个安装 @capgo/capacitor-firebase-*,没有统一包;Cordova 插件虽可用但 Capacitor 9 会引入 Cordova 运行时,建议改用原生等价物。其他具体收费、价格等资料未提供。