SuperAPI AI 工具集

capacitor-best-practices

通用与其它

查看项目

更新于 10-15 17:31

技能介绍

用途:对 Capacitor 或 Ionic + Capacitor 应用做通用代码与架构审查。适用于新建 Capacitor 项目、为现有 Web 应用添加 iOS/Android、审查 capacitor.config.ts/json(webDir、server.url、cleartext、插件与分环境配置)、检查 @capacitor/core、cli、ios、android 与插件主版本是否对齐、审查插件用法与 npx cap sync、发布前检查,以及处理“plugin is not implemented”“Could not find the web assets directory”“ios platform has not been added yet”等错误。

主要能力与规则:核心包版本必须一致,插件主版本需匹配 Capacitor 主版本;插件安装/移除或改配置后执行 npx cap sync;不手改生成产物 android/app/src/main/assets/public/ 与 ios/App/App/public/;提交 ios/ 与 android/ 源码,不提交 node_modules、Pods/、构建目录;发布配置中不得保留 server.url、cleartext、webContentsDebuggingEnabled 等开发设置;调用插件前用 Capacitor.isNativePlatform()、isPluginAvailable() 检测并提供 Web 回退;使用 checkPermissions()/requestPermissions() 权限流程;按 error.code 而非 error.message 分支;大二进制数据走文件路径并配合 Capacitor.convertFileSrc()。Capacitor 8.5 起 iOS 采用 UIScene,自定义原生代码需移至 SceneDelegate;实时更新需每次启动调用 CapacitorUpdater.notifyAppReady()。密钥不得放入应用。

使用方式:先只读盘点(npx cap doctor、npx cap ls、查看 config、判断 SPM 或 CocoaPods),按严重程度报告问题并附 file:line 与修复建议,侵入性改动先询问,再修复并运行验证(版本对齐、npm run build && npx cap sync、检查原生配置无开发标志、git status 确认生成资产未被手改、原生 Release 构建、真机测试插件含权限拒绝)。

限制:安全审计、性能、测试、调试、大版本升级、CocoaPods 转 SPM、UIScene 迁移、插件查找、商店提交、CI 与实时更新由其他技能负责。资料给出版本基线为 Capacitor 8 稳定(8.5.x)、Capacitor 9 alpha 通过 @next 安装,后者不建议用于生产。具体平台与插件细节暂未逐项提供。