用途
本技能用于引导智能体完成 Capacitor 插件从 v7 到 v8 的升级迁移。当用户表示插件面向 Capacitor 7 且需要迁移到 v8,或需要确切的 v7 到 v8 迁移路径、v8 专属的原生与包更新时,可使用本技能。
主要能力
- 读取并展示当前项目的插件与 Capacitor 包快照,包括 package.name、package.version,以及 peerDependencies、dependencies、devDependencies 中所有以 @capacitor/ 开头的依赖及其版本。
- 查找示例与原生项目路径,定位 example-app、ios、android 等目录。
- 按既定流程执行升级:确认当前 Capacitor peer 依赖范围、更新 peer 依赖范围到 Capacitor 8、查阅 v7 到 v8 迁移说明、更新示例应用、运行 npm install、同步并验证示例或测试应用。
- 提供错误处理指引,覆盖示例应用、iOS 与 Android 三类常见失败场景。
使用方式
技能从注入的项目快照开始,先确认 package.json 中当前的 Capacitor peer 依赖范围,再将其更新为 Capacitor 8。在编辑原生文件之前,应先查阅 v7 到 v8 的迁移说明。若存在示例应用,需要一并更新。随后运行 npm install,并同步与验证示例或测试应用。
技能内置的实时项目快照命令会通过 node 读取 package.json,输出插件名称、版本以及 @capacitor/ 相关依赖;同时通过 find 命令查找 example-app、ios、android 目录。
适用场景
- 插件当前面向 Capacitor 7,需要迁移到 Capacitor 8。
- 需要明确的 v7 到 v8 迁移步骤。
- 需要处理 v8 专属的原生与包更新。
限制
资料未提供该技能不适用场景的完整说明(原文描述以“Do not use for…”截断)。资料未提供具体版本号、迁移说明内容、部署目标数值、Gradle 与 Java 的具体版本要求,以及 npm install 之外的安装或构建命令细节。