9.0 KiB
9.0 KiB
Changelog
All notable changes to this project will be documented in this file.
[0.8.0] - 2026-04-08
Added
-
📱 fluttertoast 本地化 - 下载 fluttertoast v9.0.0 到本地 packages 目录
- 支持鸿蒙平台适配
- 创建
fluttertoast_ohos适配模块 - 本地路径导入,支持自定义修改
-
🎨 ToastService 消息服务 - 统一 Toast 消息样式
- 支持 4 种消息类型(success、error、warning、info)
- 自动适配 App 动态主题
- 集成 PageStandards 页面规范
- 提供简洁的 API 接口
Changed
- 📦 更新
pubspec.yaml使用本地fluttertoast - 🔧 更新
fluttertoast支持鸿蒙平台
[0.7.0] - 2026-04-08
Added
-
🔄 GetX 全局状态管理系统
BaseController基础控制器(加载状态、错误处理)PagedController分页控制器(列表分页、加载更多)HomeController首页控制器(产品列表、分类筛选、搜索)CartController购物车控制器(商品管理、数量调整、总价计算)ProfileController个人中心控制器(用户登录、登出、信息更新)
-
🧩 标准组件库 - 所有组件集成 PageStandards
StandardButton标准按钮(4 种样式:primary、secondary、outline、text)StandardTextField标准输入框(支持图标、错误提示)StandardCard标准卡片(支持阴影、边框)StandardListTile标准列表项(支持图标、副标题、箭头)
-
📊 状态组件
EmptyState空状态组件(支持图标、emoji、按钮)ErrorState错误状态组件(支持重试按钮)
-
🎯 交互组件
StandardDialog标准对话框(支持确认、取消、破坏性操作)StandardBottomSheet标准底部弹窗(支持自定义高度)StandardPicker标准选择器(支持泛型)
-
🛡️ 路由守卫系统 -
RouteGuard- 支持 3 种认证级别(none、optional、required)
- 自动重定向到登录页
- 集成 ProfileController 用户状态
Changed
- 🔄 重构
HomePage使用 GetX 状态管理 - 🔄 重构
ProductCard使用 PageStandards - 🔄 重构
LoadingIndicator使用 PageStandards
Technical
- 统一状态管理为 GetX
- 所有组件集成 PageStandards
- 实现路由守卫认证机制
- 新建页面默认支持 GetX
[0.6.0] - 2026-04-08
Added
-
📝 日志服务系统 - 新增
LoggerService完整日志管理- 支持日志开关、级别、文件写入配置
- 支持 5 种日志级别(Debug、Info、Warning、Error、Off)
- 支持控制台输出和文件输出
- 支持日志文件自动清理(按大小和数量)
- 配置持久化存储
-
📱 屏幕适配配置 - 新增
ScreenUtilConfig全局配置- 设计稿尺寸配置(默认 375x812)
- 最小字体适配开关
- 分屏模式开关
- 缩放开关控制
- 配置持久化存储
-
🔧 全局工具类
AppLogger- 简化的全局日志工具类ScreenUtilExtension- 扩展方法支持全局缩放控制
-
📐 页面规范系统 - 新增
PageStandards页面规范文件- 统一主题色、字体色、背景色配置
- 统一字体大小、间距规范
- 统一动画配置(开关、速度、预设、曲线)
- 统一响应式布局配置
- 支持多语言、屏幕方向、消息样式
- 支持状态栏沉浸、深色模式、设备类型适配
- 提供
PageStandardsMixin混入和StandardPage基类 - 提供
PageStandardsExtension扩展方法
-
🔍 页面验证系统 - 新增
PageValidator页面检测文件- 注册所有页面条目信息(路由、名称、描述、规范要求)
- 开发时实时检测页面是否遵循规范
- 支持 12 种规范检查项
- 控制台输出警告信息
- 提供验证报告和调试面板
-
📦 新增依赖库
path_provider- 文件路径获取
Changed
- 🔧 更新
AppService集成LoggerService和ScreenUtilConfig
[0.5.0] - 2026-04-08
Added
-
📱 屏幕适配库 - 新增
flutter_screenutil本地化支持- 下载
flutter_screenutil v5.9.3源码到packages/flutter_screenutil - 添加鸿蒙平台设备类型识别
DeviceType.harmonyOS - 使用条件导入处理 Web 平台兼容性
- 本地路径导入,支持自定义修改
- 下载
-
📊 新增依赖库
pretty_dio_logger- Dio 网络请求日志美化logger- 统一日志管理device_info_plus- 设备信息获取
Changed
- 📦 更新
pubspec.yaml使用本地flutter_screenutil - 📝 更新
README.md添加新依赖库说明
[0.4.0] - 2026-04-08
Added
-
✨ 动画服务系统 - 新增
AnimationService完整动画管理- 使用
animations库实现专业动画效果 - 支持动画开关、速度、强度、曲线四种参数调节
- 提供 7 种预设模式(Standard、Fast、Slow、Smooth、Bouncy、Minimal、None)
- 支持 9 种动画曲线类型(Linear、EaseIn、EaseOut、EaseInOut、Ease、Bounce、Elastic、FastOutSlowIn、SlowMiddle)
- 配置持久化存储,应用重启后保持设置
- 使用
-
🎬 页面转场动画组件 -
PageTransitionsfadeThrough淡入淡出转场fadeScale缩放淡入转场sharedAxis共享轴转场(水平/垂直/缩放)getTransitionBuilder自适应页面转场构建器
-
📋 列表项动画组件
AnimatedListItem单个列表项动画AnimatedListView列表视图动画AnimatedGridView网格视图动画- 支持交错动画效果
-
👆 交互动画组件
AnimatedButton按钮点击缩放动画AnimatedCard卡片点击交互动画OpenContainerWrapper容器展开转场
-
🎯 基础动画组件
FadeInWidget淡入动画SlideInWidget滑入动画ScaleInWidget缩放动画StaggeredAnimation交错动画
Changed
-
📱 更新
ThemeDemoPage添加完整动画设置 UI- 动画开关控制
- 预设模式选择器
- 速度和强度滑块
- 曲线类型选择器
- 实时预览区域
-
🔧 更新
AppService集成AnimationService
[0.3.0] - 2026-04-07
Added
- 🌐 繁体中文支持 - 新增
zh_Hant繁体中文本地化支持- 新增
app_zh_Hant.arb繁体中文翻译文件 - 新增
app_localizations_zh_hant.dart繁体中文实现 - 更新
app_localizations.dart支持繁体中文区域设置
- 新增
Changed
- 📱 自适应布局系统重构 - 使用
flutter_adaptive_scaffold实现响应式布局- 新增
AdaptivePageInterface抽象接口定义自适应页面规范 - 新增
AdaptivePageMixin提供单页面自适应布局实现 - 新增
AdaptiveTabPageInterface和AdaptiveTabPageMixin提供标签页自适应布局 - 新增
AdaptivePageController静态方法快速构建自适应页面 - 新增
AdaptiveLayoutBuilder响应式布局构建器 - 新增
ResponsiveGrid响应式网格组件 - 新增
ResponsivePadding响应式内边距组件 - 新增
AdaptiveDestination自适应导航目标配置
- 新增
Fixed
- 🔧 修复
flutter_adaptive_scaffoldAPI 调用错误- 修复
SlotLayoutConfig.from方法调用 - 修复
AdaptiveLayout的backgroundColor参数问题 - 修复
secondaryBody返回类型问题
- 修复
[0.2.0] - 2026-04-06
Added
- 🔐 权限管理服务 - 新增
PermissionService跨平台权限管理- 支持 15 种常见权限类型(相机、麦克风、相册、位置等)
- 跨平台权限适配(iOS、Android、HarmonyOS、Web、Windows、macOS、Linux)
- 权限状态记录和查询功能
- 批量权限检查和请求功能
Changed
- 📦 更新
pubspec.yaml依赖配置- 添加
flutter_adaptive_scaffold响应式布局支持 - 更新
permission_handler鸿蒙适配版本
- 添加
[0.1.0] - 2026-04-05
Added
- 🎨 主题服务 -
ThemeService提供统一的主题管理 - 🍎 iOS 风格组件 - 优先使用 Cupertino 组件
- 🌍 国际化支持 - 支持英文和简体中文
- 📱 基础页面结构 - HomePage、ThemeDemoPage 等
开发进度
已完成功能
- ✅ 主题服务(ThemeService)
- ✅ 动画服务(AnimationService)
- ✅ 国际化支持(en, zh, zh_Hant)
- ✅ 权限管理服务
- ✅ 自适应布局系统
- ✅ GetX 全局状态管理
- ✅ 标准组件库
- ✅ 路由守卫系统
开发中功能
- 🔄 产品列表页面
- 🔄 购物车功能
- 🔄 用户个人中心
待开发功能
- 📋 订单管理
- 📋 支付集成
- 📋 消息通知
技术栈
- 框架: Flutter
- 状态管理: GetX
- 响应式布局: flutter_adaptive_scaffold
- 动画系统: animations
- 国际化: flutter_localizations + intl
- 权限管理: permission_handler
贡献指南
- 遵循 iOS 风格设计规范
- 使用主题服务统一管理颜色和字体
- 使用动画服务统一管理动画效果
- 新增功能需更新 CHANGELOG.md
- 代码提交前运行
flutter analyze确保无错误 - 新建页面必须支持 GetX 状态管理