用途:在从零实现 Flutter 功能或完成进行中的功能时使用,提供一套实现检查清单。
主要能力与要求: 代码结构:文件放在 data/domain/view 下(DTO 放 data,Model 放 domain);DTO 使用 @JsonSerializable,Model 使用 Equatable;Repository 接口放 domain,实现放 data;复杂逻辑用 Bloc,简单逻辑用 Cubit,置于 view。 设计系统:使用 ColorPalette(禁止硬编码颜色)、Spacing(禁止魔法数字)、项目设计系统的文本组件与资源(图片/图标),以及 lib/core/widgets/ 下的核心组件。 状态管理:复杂(多事件)用 Bloc,简单用 Cubit;类上加 @injectable 自动注册;BlocProvider 放在页面层级;BlocBuilder 限定在最小子树。 错误处理:Repository 中 try-catch;将 DioException 映射为自定义异常(NetworkException、NotFoundException);Bloc/Cubit 中定义错误状态;提供用户友好提示。 测试:为 Bloc/Cubit 写单元测试(目标 90%+),用 mocktail 做 mock,测试结构与源码对应,用 fixtures 提供模拟数据。 质量:flutter analyze 零错误通过;改动后运行 ./build_runner.sh;提交 *.g.dart 文件。
使用方式:按上述清单逐项落实,遵循给出的命名、空安全、const、async/await 与 blocTest 等模式。
资源位置:扩展放 lib/core/utils/extensions/,辅助放 lib/core/utils/helpers/,校验器放 lib/core/utils/validators/。
限制:资料未提供具体安装步骤、依赖版本、收费信息或适用平台说明。