265 lines
17 KiB
Markdown
265 lines
17 KiB
Markdown
# Changelog
|
||
|
||
All notable changes to this project will be documented in this file.
|
||
|
||
|
||
## [0.96.1] - 2026-04-15
|
||
|
||
### 🐛 修复 — Flutter调试安装APK卡住 / Release构建找不到APK
|
||
|
||
#### Bug修复
|
||
- 🐛 **修复 `flutter run` 调试时 APK 安装一直卡在 "Installing build\app\outputs\flutter-apk\app-debug.apk..." 的问题**
|
||
- 原因：`local.properties` 中残留 `flutter.buildMode=release`/`flutter.versionName`/`flutter.versionCode` 等自动生成属性，干扰 Flutter 工具的构建模式判断和 APK 路径查找
|
||
- 修复：清理 `local.properties` 中的自动生成属性（这些属性由 Flutter 构建时自动写入，不应持久化）
|
||
- 修复：卸载设备上旧版本应用 + `flutter clean` 清理构建缓存
|
||
- 🐛 **修复 `flutter build apk --release` 构建后报 "Gradle build failed to produce an .apk file" 的问题**
|
||
- 原因：`android/build.gradle.kts` 中的构建目录重定向（`newBuildDir` → `../../build`）是 Flutter 新版模板的正确设计，误删后导致 APK 路径不匹配
|
||
- 修复：恢复 `build.gradle.kts` 中的 `newBuildDir` 重定向逻辑，确保 APK 输出到 `<项目根>/build/app/outputs/flutter-apk/`
|
||
|
||
## [0.96.0] - 2026-04-15
|
||
|
||
### 📧 菜谱邮件分享功能 — 发送菜谱详情到邮箱
|
||
|
||
#### 新增功能
|
||
- 🆕 **邮件分享按钮** — 菜谱详情页底部新增"📧 发送菜谱到邮箱"按钮
|
||
- 点击弹出底部对话框，支持3种发送线路选择
|
||
- 🚀 官方线路1 (gg@0gg.cc via free.mboxhosting.com)
|
||
- ✉️ 官方线路2 (2821981550@qq.com via smtp.qq.com)
|
||
- 🔧 自定义SMTP（用户填写服务器/账号/密码/端口）
|
||
- 支持纯文本+HTML双格式邮件，包含菜谱标题、简介、食材、步骤、营养信息
|
||
- HTML邮件采用iOS风格设计（渐变头部、圆角卡片、营养网格布局）
|
||
- 邮件标题格式：🍳 {菜谱名称} — 小妈厨房菜谱分享
|
||
- 输入校验：邮箱格式、必填项检查
|
||
- 发送状态反馈：发送中显示loading、成功/失败Toast提示
|
||
- 🆕 **EmailService** — 基于 `mailer` 库的SMTP邮件发送服务
|
||
- 多线路支持：官方线路1/线路2/自定义SMTP
|
||
- 支持异常捕获：MailerException/SocketException/通用异常
|
||
- Logger日志记录发送结果
|
||
- 发送成功/失败自动记录到 EmailHistoryController
|
||
- 🆕 **发件记录页面** — 足迹页统计栏新增📧发件记录入口
|
||
- 记录列表展示：菜谱标题、收件人、线路、状态、时间
|
||
- 左滑删除单条记录
|
||
- 清空全部记录
|
||
- 点击查看详情弹窗（收件人/发件人/服务器/线路/主题/状态/错误信息）
|
||
- 点击"查看菜谱"跳转菜谱详情
|
||
- 统计头部：总记录数 + 成功/失败数量标签
|
||
- 🆕 **EmailRecordModel** — 邮件发送记录模型（SharedPreferences JSON持久化）
|
||
- 🆕 **EmailHistoryController** — 邮件记录控制器（最多200条记录）
|
||
|
||
#### Dependencies
|
||
- 新增: mailer ^7.1.0
|
||
|
||
#### 影响文件
|
||
- `pubspec.yaml` — 添加 mailer 依赖
|
||
- `lib/src/services/data/email_service.dart` — 新建邮件发送服务（多线路+历史记录）
|
||
- `lib/src/widgets/recipe_detail/interaction/recipe_email_button.dart` — 新建邮件按钮组件
|
||
- `lib/src/models/data/email_record_model.dart` — 新建邮件记录模型
|
||
- `lib/src/controllers/data/email_history_controller.dart` — 新建邮件记录控制器
|
||
- `lib/src/pages/profile/social/email_history_page.dart` — 新建发件记录页面
|
||
- `lib/src/pages/profile/social/footprints_page.dart` — 统计栏增加发件记录入口
|
||
- `lib/src/pages/home/recipe_detail_page.dart` — 底部添加邮件按钮
|
||
- `lib/src/config/app_routes.dart` — 注册 /email-history 路由
|
||
|
||
|
||
## [0.95.0] - 2026-04-14
|
||
|
||
### 🔄 MiniCardPage 滑动引擎重构 — 引入 flutter_card_swiper
|
||
|
||
#### 重构
|
||
- 🔄 **自定义手势系统移除** — 移除 GestureDetector + 3个AnimationController（exit/enter/bounce）+ 手动拖拽追踪(_dragX/_dragY) 的自实现滑动系统
|
||
- 🔄 **引入 flutter_card_swiper ^7.2.0** — 使用专业 Tinder 风格卡片滑动库替代自实现
|
||
- CardSwiper 内置：滑动动画、回弹效果、堆叠缩放、旋转角度
|
||
- CardSwiperController 支持程序化控制：swipe(direction)、undo()、moveTo(index)
|
||
- onSwipe/onUndo 回调统一处理 like/dislike/撤销逻辑
|
||
- 配置：threshold=80, maxAngle=20, scale=0.92, duration=300ms, numberOfCardsDisplayed=2
|
||
|
||
#### 删除代码（-158行）
|
||
- ~~_exitAnimController / _enterAnimController / _bounceAnimController~~ — 3个AnimationController
|
||
- ~~/_dragX / _dragY / _isDragging / _isAnimatingExit / _exitDirection / _exitStartX / _exitStartY~~ — 手势状态变量
|
||
- ~~/_swipeRight() / _swipeLeft() / _startExitAnimation() / _onExitComplete() / _goPrev() / _bounceBack() / _buildSwipeLabel()~~ — 7个手势方法
|
||
|
||
#### 新增代码（+30行）
|
||
- `CardSwiperController _swiperController` — 程序化控制器
|
||
- `_handleSwipe(previousIndex, currentIndex, direction)` — 统一滑动回调
|
||
- `_handleUndo(previousIndex, currentIndex, direction)` — 撤销回调
|
||
- `CardSwiper` widget 替代原 `GestureDetector + Transform` 嵌套
|
||
|
||
#### 保留功能（100%不变）
|
||
- ✅ 分类筛选 / 搜索 / 网格视图切换
|
||
- ✅ 收藏 / 分享 / 详情跳转 / 全屏查看器
|
||
- ✅ 图片预加载 / 本地缓存 / SharedPreferences持久化
|
||
- ✅ MiniCardImageView 组件（液态玻璃效果）
|
||
- ✅ MiniCardViewer 全屏查看器
|
||
|
||
#### Dependencies
|
||
- 新增: flutter_card_swiper ^7.2.0
|
||
|
||
#### 影响文件
|
||
- `pubspec.yaml` — 添加 flutter_card_swiper 依赖
|
||
- `lib/src/pages/discover/mini_card/mini_card_page.dart` — 核心重构（1262行→1104行，减少12.5%）
|
||
- `lib/src/pages/discover/mini_card/mini_card_image_view.dart` — 分类描述提升为独立显眼行（fontSm + 85%透明度 + 2行显示）
|
||
|
||
#### 补充修复（v0.95.0-hotfix）
|
||
- 🐛 **卡片右侧空白** — CardSwiper padding 从 `horizontal:16` 改为 `EdgeInsets.zero`，内部 width 从 `maxW-32` 改为 `constraints.maxWidth`
|
||
- 🎨 **底部层叠效果** — 布局从 Column 重构为 Stack，底部操作栏使用 `Positioned(bottom:0)` + `BackdropFilter(sigma:20)` + 渐变遮罩(0→0.95)，卡片视觉延伸至按钮下方
|
||
- 🏷️ **分类栏** — `_buildCategoryChips` 已正确遍历 `_meta.categories.entries`，显示全部11个分类（✨全部 🥬素菜 🥩荤菜 🦞水产 🌅早餐 🍚主食 🍲汤与粥 🧃饮品 🍰甜品 📦半成品加工 🪙酱料）
|
||
- 📝 **分类描述** — MiniCardImageView 已通过 `_meta.descriptions[recipe.category]` 获取对应分类描述，独立行显示
|
||
|
||
|
||
## [0.94.0] - 2026-04-14
|
||
|
||
### 🎬 迷你卡片动画系统重构 — 滑出飞走+入场弹性+回弹弹簧+图片预加载+缓存
|
||
|
||
#### 优化
|
||
- 🎬 **滑出飞走动画** — 拖拽超过阈值后，卡片带旋转+位移飞出屏幕（easeIn加速），不再瞬间跳变
|
||
- 🎬 **入场弹性动画** — 新卡片从 scale 0.88→1.0 + opacity 0→1 弹性进入（easeOutBack回弹曲线）
|
||
- 🎬 **回弹弹簧动画** — 拖拽未达阈值时，卡片平滑弹回原位（easeOut减速），不再硬切
|
||
- 🎬 **下一张卡片联动** — 滑出过程中，下一张卡片从 scale 0.92→1.0 + opacity 0.6→1.0 逐渐浮现
|
||
- 🖼️ **图片预加载** — 切换卡片时 precacheImage 预加载后续3张图片，消除转圈等待
|
||
- 🖼️ **CachedNetworkImage 替换** — MiniCardImageView/MiniCardViewer/MiniCardPage 全部替换 Image.network → CachedNetworkImage
|
||
- 磁盘缓存 maxWidthDiskCache/maxHeightDiskCache: 800/1200
|
||
- 内存缓存 memCacheWidth/memCacheHeight: 800
|
||
- fadeIn 300ms easeOut 渐入效果
|
||
- 🎬 **滑出动画期间禁止拖拽** — 防止动画中重复触发滑动手势
|
||
|
||
#### Bug修复
|
||
- 🐛 **动画控制器未绑定** — 原 _likeAnimController/_nopeAnimController 创建后从未驱动任何动画，卡片切换全靠 setState 硬切
|
||
- 🐛 **图片无缓存** — Image.network 每次切换都重新请求网络，导致转圈加载
|
||
|
||
#### 影响文件
|
||
- `lib/src/pages/discover/mini_card/mini_card_page.dart` — 动画系统重构+CachedNetworkImage+预加载
|
||
- `lib/src/pages/discover/mini_card/mini_card_image_view.dart` — CachedNetworkImage替换
|
||
- `lib/src/pages/discover/mini_card/mini_card_viewer.dart` — CachedNetworkImage替换
|
||
|
||
## [0.93.0] - 2026-04-14
|
||
|
||
### 🎨 视觉拉满 + 滚动卡顿修复 + 布局Bug修复
|
||
|
||
#### 优化
|
||
- 🎨 **液态玻璃效果拉满** — 迷你卡片3层BackdropFilter+光感折射+荤素标签玻璃效果
|
||
- 🎨 **底部栏恢复毛玻璃** — 瀑布流底部状态栏恢复BackdropFilter(sigmaX/Y:20)+渐变+边框
|
||
- 🖼️ **CachedNetworkImage** — 迷你卡片图片改用CachedNetworkImage，避免滚动时重复网络请求
|
||
- 🏗️ **ValueNotifier隔离** — 副栏显隐状态改用ValueNotifier，不再触发全局setState重建瀑布流
|
||
- 🏗️ **merge保留缓存** — DiscoverData.merge()保留已有flattenedItems缓存并追加新项，避免重新shuffle导致滚动跳动
|
||
- 🏗️ **RepaintBoundary** — 迷你卡片添加RepaintBoundary隔离渲染，不影响其他卡片绘制
|
||
|
||
#### Bug修复
|
||
- 🐛 **滚动卡顿** — 移除_applyPendingDiscoverIfAny中的clearCache()调用，避免滚动中列表重新shuffle
|
||
- 🐛 **Column溢出** — 错误页和空数据页改用SingleChildScrollView包裹，防止溢出
|
||
- 🐛 **SliverMasonryGrid null check** — 空chunk不再创建SliverMasonryGrid，防止null check错误
|
||
- 🐛 **tag_discover_card溢出** — 标签类型和数量文字添加Flexible包裹，防止Row溢出
|
||
- 🐛 **image_viewer_page** — _extractImageUrl改为imageUrlExtractor回调参数，修复未定义方法错误
|
||
- 🐛 **discover_waterfall Colors** — 添加material导入，修复Colors未定义错误
|
||
- 🐛 **主页缓存恢复** — _loadDiscover已有数据时使用merge而非替换，保持列表顺序稳定
|
||
|
||
#### 影响文件
|
||
- `lib/src/pages/home/home_page.dart` — ValueNotifier隔离+merge策略+布局修复
|
||
- `lib/src/widgets/discover/mini_card_discover_card.dart` — 液态玻璃拉满+CachedNetworkImage+RepaintBoundary
|
||
- `lib/src/widgets/discover/discover_waterfall.dart` — 底部栏毛玻璃+空chunk保护+material导入
|
||
- `lib/src/widgets/discover/tag_discover_card.dart` — Row溢出修复
|
||
- `lib/src/models/discover_model.dart` — merge保留flattenedItems缓存
|
||
- `lib/src/widgets/image_viewer/image_viewer_page.dart` — imageUrlExtractor回调
|
||
|
||
## [0.92.9] - 2026-04-14
|
||
|
||
### 🃏 迷你卡片优化 — 液态玻璃效果+详情跳转+Bug修复
|
||
|
||
#### 优化
|
||
- 🎨 **液态玻璃效果重设计** — 底部信息区改为"装水玻璃杯"效果
|
||
- 使用 ClipRect + BackdropFilter(sigmaX/Y: 30) 实现高斯模糊
|
||
- 顶部白色半透明边框(0.25 alpha)模拟光线折射
|
||
- 渐变背景(0.05→0.12 alpha)模拟水杯透明度
|
||
- 文字添加 Shadow(black54/black38) 增强可读性
|
||
- 按钮使用渐变玻璃效果(0.25→0.1 alpha)替代纯色
|
||
- 🆕 **categoryName 显示** — 迷你卡片底部信息区显示分类名称标签（液态玻璃胶囊样式）
|
||
- 🆕 **详情按钮API搜索** — 点击详情按钮通过 RecipeRepository.search() 搜索菜名获取API真实ID，再跳转菜谱详情页
|
||
- 🆕 **全屏查看器详情按钮** — 全屏查看器中详情按钮也通过API搜索跳转
|
||
|
||
#### Bug修复
|
||
- 🐛 **setState after dispose** — _goNext()/_goPrev() 添加 mounted 检查，防止动画回调在页面销毁后调用 setState
|
||
- 🐛 **MediaQuery initState 报错** — 图片预加载从 initState 移至 didChangeDependencies
|
||
- 🐛 **分享功能改为图片分享** — 使用 RepaintBoundary 截取卡片组件为PNG图片，通过 ShareXFiles 分享
|
||
- 🐛 **PaginatedData 缺少 totalPages** — 补充必需参数
|
||
|
||
#### 影响文件
|
||
- `lib/src/pages/discover/mini_card_page.dart` — 液态玻璃重设计+详情跳转+Bug修复
|
||
|
||
## [0.92.8] - 2026-04-14
|
||
|
||
### 🃏 迷你卡片页面 — Tinder风格滑动浏览菜品 + 首页瀑布流插入
|
||
|
||
#### 新增功能
|
||
- 🆕 **迷你卡片页面** — 交友软件风格左右滑动浏览菜品
|
||
- 数据源：`/assets/recipes.json`（341道菜，11个分类）
|
||
- 图片URL：`https://eat.wktyl.com/api/assets/mpic/{id}.jpeg`
|
||
- 左右拖拽滑动切换菜品卡片，拖拽距离>80触发滑动
|
||
- 滑动时显示"❤️ 喜欢"或"👎 下一道"标签
|
||
- 底部4个操作按钮：下一道/收藏/喜欢/上一道
|
||
- 进度条显示浏览进度
|
||
- 🆕 **分类筛选** — 顶部横向滚动分类标签（全部/素菜/荤菜/水产等11类）
|
||
- 🆕 **搜索功能** — 搜索菜品名称，点击结果跳转到对应卡片
|
||
- 🆕 **网格视图** — 卡片/网格双视图切换，响应式布局（2/3/4列）
|
||
- 🆕 **收藏集成** — 卡片右上角收藏按钮，与全局收藏系统联动
|
||
- 🆕 **本地缓存** — SharedPreferences存储5-10条记录（不含图片），离线fallback
|
||
- 🆕 **喜欢/不喜欢记录** — 持久化到SharedPreferences，重启保留
|
||
- 🆕 **缓存管理** — 缓存管理页面新增迷你卡片缓存清理入口
|
||
- 🆕 **图片独立组件** — _MiniCardImageView 独立组件，文本在图片内底部展示
|
||
- 🆕 **液态玻璃效果** — 卡片顶部操作栏和底部信息区使用 GlassContainer 毛玻璃
|
||
- 🆕 **全屏图片查看器** — 点击卡片打开全屏 PageView，左右滑动切换，异步预加载5张相邻图片
|
||
- 🆕 **分享按钮** — 使用 share_plus 分享菜品信息+图片URL
|
||
- 🆕 **缓存优先加载** — 查看过的卡片存入缓存，下次进入先显示缓存再内部加载
|
||
- 🆕 **首页瀑布流插入** — 迷你卡片以全宽横幅插入首页瀑布流（1:20比例）
|
||
- 每20个瀑布流item后插入1个迷你卡片横幅
|
||
- 点击横幅跳转迷你卡片页面（支持指定卡片ID）
|
||
- MiniCardDiscoverCard 组件：液态玻璃+全宽图片+分类标签
|
||
- 🆕 **MiniCardService** — 独立数据服务，支持缓存优先，供多页面复用
|
||
- 🆕 **路由参数支持** — 迷你卡片页面支持 initialRecipeId 参数，从首页跳转到指定卡片
|
||
|
||
#### 入口
|
||
- 个人中心 → 迷你卡片（原null路由已连接）
|
||
- 首页瀑布流 → 迷你卡片横幅（每20个item后出现）
|
||
|
||
#### 影响文件
|
||
- `lib/src/models/mini_card_model.dart` — 新建数据模型
|
||
- `lib/src/pages/discover/mini_card_page.dart` — 重构：图片独立组件+全屏查看器+分享+缓存优先
|
||
- `lib/src/config/app_routes.dart` — 路由支持 initialRecipeId 参数
|
||
- `lib/src/pages/profile/profile_home.dart` — 连接入口
|
||
- `lib/src/pages/profile/data/cache_manage_page.dart` — 新增迷你卡片缓存管理
|
||
- `lib/src/widgets/discover/mini_card_discover_card.dart` — 新建瀑布流迷你卡片横幅组件
|
||
- `lib/src/widgets/discover/discover_waterfall.dart` — 支持迷你卡片插入（SliverMainAxisGroup）
|
||
- `lib/src/models/discover_model.dart` — 新增 miniCard 类型和 MiniCardRecipeRef
|
||
- `lib/src/services/data/mini_card_service.dart` — 新建迷你卡片数据服务
|
||
- `lib/src/pages/home/home_page.dart` — 加载迷你卡片数据，传递给瀑布流
|
||
|
||
## [0.92.7] - 2026-04-14
|
||
|
||
### 🧬 营养成分交互增强 + 食材详情页修复
|
||
|
||
#### 新增功能
|
||
- 🆕 **营养成分展开更多** — 菜品详情页详细营养成分标题右侧新增"更多"按钮
|
||
- 点击弹出底部对话框（CupertinoModalPopup），从下到上弹出
|
||
- 每个营养成分显示emoji图标+名称+数值+跳转提示
|
||
- 点击营养成分跳转到含该成分的菜品列表页
|
||
- 营养成分emoji映射表（31种营养成分对应emoji）
|
||
- 🆕 **营养成分菜品列表页** — 新增 NutritionRecipeListPage
|
||
- 使用 `api_filter.php?act=filter_recipes&nutrition_name=` 接口查询
|
||
- 支持分页加载，显示菜品卡片+图片
|
||
- 路由: `/nutrition-recipe-list`
|
||
|
||
#### 修复内容
|
||
- 🐛 **食材详情菜谱数量显示0** — 修复 `recipeCount` 始终为0的问题
|
||
- 根因：API `ingredient_detail` 不返回 `statistics` 字段，但返回 `related_recipes` 数组
|
||
- 修复：IngredientModel 新增 `relatedRecipes` 字段和 `effectiveRecipeCount` getter
|
||
- 当 `statistics.recipeCount` 为0时，fallback 到 `related_recipes.length`
|
||
- 同时支持 `recipe_count` 和 `view_count` 顶层字段
|
||
- 🔧 **食材详情卡片位置调整** — 将"食材详情"卡片移到"储存方法"下面
|
||
|
||
#### 影响文件
|
||
- `lib/src/widgets/recipe_detail/info/recipe_nutrition_section.dart` — 新增展开更多+弹窗+跳转
|
||
- `lib/src/pages/discover/nutrition_recipe_list_page.dart` — 新建
|
||
- `lib/src/config/app_routes.dart` — 新增路由
|
||
- `lib/src/models/recipe/ingredient_model.dart` — 新增relatedRecipes+effectiveRecipeCount
|
||
- `lib/src/pages/tools/ingredient_detail_page.dart` — 修复count+调整卡片顺序
|
||
|
||
> 📌 已移除较早版本记录(0.92.6及之前)，功能已归档至软件特性清单。
|