feat: add elastic glass dock motion and Android tablet layouts

2026-10-28 11:09:43 +08:00
parent fbcb7fb637
commit 9da5864d29
16 changed files with 1321 additions and 874 deletions
@@ -1,6 +1,6 @@
 # Android 首版验证记录

-当前版本为0.7.8+28，通知权限恢复、通道初始化及真实后台触发见[通知记录](tpschedule-0.7.8-notification-permissions.md)。Dock乳白透光材质见[优化记录](tpschedule-0.7.8-dock-refinement.md)。本科/研究生HTML反馈及签名、备案信息见[0.7.8功能记录](tpschedule-0.7.8-validation.md)。应用更新检查与后台说明见[0.7.6记录](tpschedule-0.7.6-updates.md)。本科考试兼容的验证见[0.7.5记录](tpschedule-0.7.5-validation.md)。两例真实课表缺失字段问题待新页面定位。本科接入记录见[0.7.0记录](tpschedule-0.7.0-validation.md)。下文为首版历史记录。
+当前版本为0.7.8+29，Dock弹性与Android平板验证见[本次记录](tpschedule-0.7.8-dock-tablet.md)。构建28的通知权限恢复、通道初始化及真实后台触发见[通知记录](tpschedule-0.7.8-notification-permissions.md)。Dock乳白透光材质见[优化记录](tpschedule-0.7.8-dock-refinement.md)。本科/研究生HTML反馈及签名、备案信息见[0.7.8功能记录](tpschedule-0.7.8-validation.md)。应用更新检查与后台说明见[0.7.6记录](tpschedule-0.7.6-updates.md)。本科考试兼容的验证见[0.7.5记录](tpschedule-0.7.5-validation.md)。两例真实课表缺失字段问题待新页面定位。本科接入记录见[0.7.0记录](tpschedule-0.7.0-validation.md)。下文为首版历史记录。

 日期：2026-10-13。测试环境：Flutter 3.47.7 / Dart 3.13.5 / JDK 17；Android 16 API 36，Pixel 7 模拟器，1080×2400。首版版本 0.1.0+1，包 ID com.example.hepan_everyday，最低 Android 7.0（API 24）。

@@ -0,0 +1,10 @@
+# Dock 与平板实现计划
+
+本会话直接实现。版本保留0.7.8，构建号递增29。旧APK、登记备份和密钥保持原样。
+
+1. 先修改点按动画测试为新需求，增加连续反向点击、外层联动和减少动画断言，运行并确认失败。
+2. 实现单一位置弹簧、短暂点按形变和外层独立布局形变，保留实时折射和稳定图标层。拖动速度和位移必须有界，父组件确认选中状态不能重启动画。
+3. 增加平板/分屏布局测试，覆盖七天同屏、宽屏文字、内容限宽、横竖屏切换与操作。实现共用AdaptivePage和宽屏课表文字、Dock宽度适配，并覆盖设置和反馈。
+4. 运行受影响测试、完整测试和静态分析；正式构建，检查Android模拟器手机/平板与动画关键帧，审查改动。保存版本化APK、源码、更新说明，校验签名/旧文件与登记备份。
+
+审查重点：连续点击时位置连续；外层形变采样与实际布局一致；拖动取消无误切页；窗口缩放不重置标签/周；小窗口及大字体无溢出；减少动画无弹性。
@@ -0,0 +1,13 @@
+# Dock 弹性与 Android 平板适配
+
+用户要求参考本地视频 20261028-104403.mp4：点按和拖动均有弹性落位，拖动滑块带动外层 Dock，玻璃下内容可辨，图标文字清楚；同时支持平板。沿用用户已授权直接执行的工作方式，不追加确认流程。
+
+采用现有 Flutter 弹簧动画和实时背景折射，不引入浏览器或新玻璃组件库。相比整体放大变换，这样能通过实际布局更新玻璃区域，避免非等比变换造成采样坐标偏移；相比仅加大模糊，可保留背景颜色与轮廓。
+
+- 滑块：点按短促伸缩和轻微弹簧落位；连续点击从当前位置、速度接续；拖动仍放大，松手回弹，取消不换页。
+- 外层：按压与拖动引起小幅扩张，轻微向滑块所在侧延伸；文字和图标单独绘制，保持稳定清晰。静止仍为灰色滑块、浅白通透玻璃、蓝色图标白光。高度保持紧凑。
+- 无障碍：减少动态效果时直接落位，不播放放大、抖动或外层形变。
+- 平板：根据当前窗口宽度适配，兼容横竖屏和分屏。宽度不足600逻辑像素维持手机布局；宽屏课表最多1440，考试/个人页最多840，设置/反馈最多760，居中留边。课表保持七天同屏，并在宽列增大课程和时间文字。Dock 平板宽300、高58，手机264×58；不添加侧栏。
+- Android 沿用可旋转/可调整大小的默认 Activity，不改变签名、权限、包名及持久化格式。不宣称已验证 iPad。
+
+验证：点按弹性、快速反向点按、按住/拖动外层变化、取消、减弱动态效果；手机与800×1280、1280×800平板和分屏布局无溢出，七天可见，切页/周状态保留，设置/反馈可用；完整测试、分析、正式签名APK和模拟器视觉检查。
@@ -0,0 +1,25 @@
+# 0.7.8+29 Dock 弹性与 Android 平板适配
+
+参考用户提供的 20261028-104403.mp4，保留浅白通透底座、灰色静止滑块、蓝色图标白光和课表/考试/我的文字。
+
+点按改为弹簧移动，移动中短暂拉伸，落位有克制回弹。连续点按继承位置和速度，未结束的尺寸脉冲继续播放，避免重新开始导致边缘跳动。拖动滑块继续放大并变通透；底座随按压和拖动方向轻微扩张、偏移、回弹。通过调整玻璃实际布局范围实现，图标和文字保持独立，未对整个Dock做拉伸变换。沿用原折射着色器和轻模糊，不增加雾化程度。
+
+当前窗口达到600逻辑像素时Dock宽300，高58；窄窗口保持264×58。课表区域最多1440宽，考试和我的最多840宽，设置和反馈最多760宽，居中留边。课表每列足够宽时使用更大字号，并用同样字号重新计算老师、教室的完整显示高度。仍为七天同屏和统一节次高度，课程名可省略并点开详情。横竖屏和分屏缩放保留当前标签、周次和滚动状态。
+
+系统减少动画时直接落位，关闭形变；动画运行中开启该设置会清零尺寸脉冲，重新关闭也不会留下冻结形变。
+
+## 验证
+
+- 314项Flutter测试通过，静态分析无问题，正式APK构建成功。
+- 新增/更新行为测试覆盖：点按弹性和有界回弹，快速连续反向点按（90ms、230ms，检查位置与尺寸连续），拖动外框联动、取消归位、减少动画即时/运行中切换、Dock常驻。
+- 布局测试覆盖800×1280及1280×800，缩窄到480×800，七天可见、切换标签返回时周次不变、设置/反馈在1.5倍字号下无溢出并可输入。
+- 旧冲突卡片测试在更大字号下出现2.84e-14的浮点边界差异，改为0.001逻辑像素容差；课程仍为上下相接，无可见重叠。
+- Android16/API36测试模拟器安装正式APK成功；1920×1200和1200×1920物理尺寸、密度240分别对应1280×800和800×1280逻辑窗口。实际打开示例课表、切换页面、换周并改变屏幕方向，周次保留；恢复手机尺寸也正常。检查截图并录制点按/拖动动画，未发现Flutter或AndroidRuntime致命错误。
+- 模拟器原生页面检查使用兼容软件渲染，验证布局和动画；支持着色器的Flutter测试另行通过，包含背景颜色、柔化、边缘折射和坐标对齐测试。未在实体平板或iPad上验证，不把兼容渲染截图当作实体设备折射效果的证明。
+- 独立审查发现的两项动画边界问题均先用测试复现再修正：中途开关减少动画的冻结脉冲；连续点击重置脉冲/限速导致尺寸跳变。修正后全套314项测试通过。
+
+## 交付
+
+显示版本0.7.8，构建号29，包名com.tpschedule.app。APK、源码和截图按构建号保存于dist。签名MD5仍为78 DE 91 19 AD 14 72 7F A1 C5 E5 E4 E6 81 45 EE；证书和RSA公钥与28一致。密钥、旧版本安装包和0.5.4登记冻结资料保持原样。
+
+这次只更新APP，不需要更新服务器。若使用更新后台推送，填写版本0.7.8、构建号29，并提供本次APK对应的HTTPS下载链接。