520kiss/kitchen
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Files
efaff0c692d408b605c2dd46b25d20f2d634dc74
kitchen/CHANGELOG.md

8.4 KiB
Raw Blame History

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 状态管理
Reference in New Issue View Git Blame Copy Permalink