SuperAPI AI 工具集

flutter-dependency-upgrades

通用与其它

查看项目

更新于 10-16 02:30

技能介绍

用途:该技能面向 Flutter/Dart 项目的依赖与 SDK 升级,帮助规划、执行或审查版本迁移,覆盖依赖解析、锁文件变更、包破坏性变更和兼容的原生工具链调整。核心理念是升级最小的自洽版本集,并保留可复现证据;不要在整个项目范围执行大版本升级,也不要在未理解项目约束前删除锁文件或添加 override。

主要能力与做法:升级前先做预检,阅读所有相关 pubspec.yaml、生效的锁文件或 Pub workspace 解析结果、Flutter/Dart SDK 约束、版本管理器文件、CI 工具链固定版本、启用的平台、原生构建版本、代码生成器、生成文件策略以及待处理的工作区变更;并区分应用与发布包,因为二者的锁文件与兼容义务不同。用仓库既有的依赖获取、生成、分析、测试与代表性目标构建建立干净基线;若基线已失败,先与升级问题分离。

升级时先定义目标:单个包、相关包组、安全修复、Flutter/Dart SDK 或原生工具链要求。查看当前、可升级、可解析和最新版本,以及官方 changelog、迁移指南、SDK 边界、平台支持和已知不兼容;可用时借助 Dart 与 Flutter MCP 的包和分析能力交叉核对版本与 API 变化,否则依赖 dart pub outdated / flutter pub outdated 与 changelog 审查。每次只改一个自洽层次,保留仓库的版本管理器、包来源与架构;仅通过项目自有命令重新生成,检查 API 与生成差异,审查每处非预期锁文件变更;在扩展下一批升级前重跑基线检查与受支持目标构建。自动修复需先审查范围;依赖解析成功不等于源码、生成代码、原生构建或运行时行为仍兼容。

细节按需加载:SDK 与包升级、解析冲突与 override、平台工具链迁移分别对应不同章节。边界上,dart-language 负责源码现代化,flutter-security 负责安全公告与抑制决策,flutter-ci-cd 负责流水线编排,flutter-build-release 负责签名与发布产物;本技能负责兼容版本图与迁移证据。未获明确授权不得发布、发版、轮换凭据或更改签名材料。完成时报告最终 SDK/包/工具链版本、有意的锁文件变更、已应用迁移、已运行检查、未执行的受支持目标,以及遗留的临时 override 或兼容债务。具体命令与平台支持细节暂未提供。