用途:在改动 Flutter 或 Dart 应用、包、插件、嵌入器、构建自动化或开发工具之前,先读取与该任务匹配的参考文档,再选择 API 或迁移路径,避免使用已失效的旧标志、生成文件和属性。资料列出了 11 个参考主题:可访问性与输入测试、Android、Apple 平台、Dart 语言、Dart 工具与包、桌面与嵌入、迁移与破坏性变更、导航布局与动画、工具构建资产与插件、Web 渲染与图形、组件与主题。
使用方式:先检查 pubspec.yaml、平台工程和 CI 脚本,再针对涉及的每个平台或 API 阅读对应主题,先完成必需迁移再添加新行为;优先使用当前属性和命令形式,不因旧工程仍含已移除标志或生成产物而保留它们;当行为因目标而异时,需在每个受影响的渲染器、操作系统、输入模式和可访问性配置上测试。
主要迁移要点:Android 改用声明式 Gradle 插件设置,移除 v1 嵌入并迁移到 v2,采用边到边和可调整尺寸布局;Apple 将生命周期迁移到 UIScene,Swift Package Manager 管理常规插件;Dart 侧约束提升后先运行 dart pub get 再格式化,使用 dart fix(dart format --fix 已不存在),直接声明导入的包,用 dart:js_interop 和 package:web 替代旧 Web 库,本地化代码从真实输出导入,package:flutter_gen 已移除;Web 不可再选已删除的 HTML 渲染器,Impeller 在 Web 上不存在。
验证清单:运行 flutter analyze 及相关分析器插件诊断;运行单元、组件、语义和集成测试;练习路由完成、预测性返回、表单重置、键盘遍历和选择行为;构建每个受影响目标并检查 Wasm、Gradle、Xcode、插件元数据、资产及已移除 CLI 选项的警告;开启平台屏幕阅读器和用户偏好验证可访问性。
限制:资料以参考主题清单和迁移指导为主,未提供安装命令、价格、许可、具体版本号或完整代码示例;部分新增能力(如 Widget Preview、分析器插件、构建钩子与原生资产)仅给出配置要点,未说明全部细节。