Flutter Zero Template 1.0.0 发行说明
企业级 Flutter MVI 模板首个正式版本。基于 Flutter 3.44.4 / Dart 3.12.2(stable)。
概述
flutter_zero_template 是一套开箱即用的 Flutter 企业级 MVI 模板,通过 Mason Brick 分发,配套 fluzer CLI 生成项目与功能模块。约定:Event=Intent、Bloc=ViewModel、State=ViewState、Page=View。
核心特性
- 四 BLoC Mixin:
BlocAwaitMixin(可等待)、BlocCancelTokenMixin(取消/去重/生命周期绑定)、BlocEffectMixin(副作用流)、BlocErrorHandlerMixin(错误归一化)。 - Effect 与 Notifiers 系统:开放
UIEffect基类(ToastEffect/DialogEffect/LoadingEffect),EffectListener责任链 + 框架默认 handle,桥接Notifiers弹层,副作用不污染 State。 - 错误归一化:
AppException抽象体系 +Result<T>(Success/Failure/Cancel)+ErrorHandler单一转换点;BaseRepository.parseBusinessResponse<T,B>结构化解析业务响应。 - 三文件依赖注入:
get_it_instance(全局)/injection_base(脚本自动维护registerFeatureModules)/injection(手写业务注册)。 - 技术栈:
flutter_bloc、dio、go_router、get_it、freezed+json_serializable、very_good_analysis(禁用 4 条 lint)。
快速开始
# 安装 CLI
dart pub global activate fluzer
# 创建项目
fluzer create my_app --org com.example
# 新增功能模块
fluzer new login