chore: update CHANGELOG for v0.7.0 with GetX and component updates

2026-04-08 01:41:23 +08:00
parent e255b5c650
commit efaff0c692
1 changed files with 242 additions and 0 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -0,0 +1,242 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [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）
+  - 配置持久化存储，应用重启后保持设置
+
+- 🎬 **页面转场动画组件** - `PageTransitions`
+  - `fadeThrough` 淡入淡出转场
+  - `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_scaffold` API 调用错误
+  - 修复 `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
+
+---
+
+## 贡献指南
+
+1. 遵循 iOS 风格设计规范
+2. 使用主题服务统一管理颜色和字体
+3. 使用动画服务统一管理动画效果
+4. 新增功能需更新 CHANGELOG.md
+5. 代码提交前运行 `flutter analyze` 确保无错误
+6. **新建页面必须支持 GetX 状态管理**