docs(plans): 留痕 K58 浅色开屏

This commit is contained in:
Zhou Weidong committed 2026-10-20 18:38:34 +08:00
1 parent 374b0bd89c
commit de8f02a542
2 files changed
+46 -16

No files matched your search

+16 -16
View File
@@ -1,23 +1,23 @@
## [已处理] 2026-10-20 | K57-A iOS 视频未加载诊断 + 封面→视频切换防闪(仅 App 端)
## [已处理] 2026-10-20 | K58-A 开屏改浅色(去掉原生黑屏)+ 自定义开屏文字加深(仅 App 端)
**用户指令(2026-10-20,原文)**:
> 「iOS 视频资源未加载出来 显示封面有另一个问题 会闪屏 封面会闪一下」
> 「现在安卓端安装的app 图标没有改为最新的 还有原来的启动屏弄成透明的 不然会黑屏 另外 自定义的启动屏的字体看不清」
**口径(只改 Flutter,不动后端、不改接口)**
1. 视频状态可观测(仅 `kDebugMode`):
- 播放页/首页 feed 在封面占位右下角显示 11 号小字(Key `player-debug-video`):`initialized` / `buffering` / `error: <controller.value.errorDescription>` / `loading`;
- 状态变化时 `debugPrint('[video] init=... err=... url=<脱敏后的 host:port>')`。
2. 封面→视频防闪:
- 封面占位(`player-fallback-background`)始终作为底层背景保留;
- 视频层用 `AnimatedOpacity`(200ms)淡入,条件为 `value.isInitialized && value.size.width > 0` 且已收到首帧(`ValueListenableBuilder` 里用 `value.position > Duration.zero || value.isPlaying` 判定,或监听首帧后置位);
- 未完成淡入前不卸载封面,避免「封面消失 → 黑帧 → 视频」造成的闪一下;
- 切换过程中不重建 `VideoPlayer` 组件(保持同一个 controller 与 Key)。
3. iOS 视频源排查辅助:debug 下若 `controller.value.hasError`,在封面占位中央显示错误摘要(最多 3 行,Key `player-video-error`),并保留现有重试入口。
4. Android 行为不变(有封面时同样走淡入)。
**口径(只改 Flutter / 原生启动资源)**
1. 原生启动不再黑屏:
- `android/app/src/main/res/drawable*/launch_background.xml` 保持仅纯色,但颜色改为与 Flutter 开屏一致的浅暖色 `#FFF8F0`(`splash_background` 同步修改);
- `values-v31` / `values-night-v31` 的 `windowSplashScreenBackground` 一并改成 `#FFF8F0`,`windowSplashScreenAnimatedIcon` 继续使用透明 drawable;
- 这样原生阶段是浅暖底,不会出现黑屏,也与 Flutter 开屏无缝衔接(Android 12 的 splash 背景必须给不透明色,纯透明会被系统渲染成黑色)。
2. Flutter 自定义开屏改浅色主题,解决文字看不清:
- 背景 `AppColors.ink`(#FFF8F0),状态栏深色图标;
- `FruitShorts` 改 `AppColors.onSurface` 28 号 w900;「水果短剧」改 `AppColors.muted` 13 号、字距 4;
- logo 柔光改 `0x33FF7A1A`;转圈保持主题橙;
- 动画时序、Key(splash-screen/splash-brand/splash-tagline/splash-loading)全部保留。
3. 图标无需改图:最新 APK 已重装到 Android 设备(图标资源已在包内);若桌面仍显示旧图标属启动器缓存,重启桌面/重新添加图标即可,代码侧不做处理。
**测试/门禁**
- 新增:未初始化时封面可见且视频 opacity 0;初始化后 200ms 内过渡到 1;有错误时出现 `player-video-error` 且封面仍在;
- 更新开屏测试:背景为 `AppColors.ink`、品牌文字颜色为 `AppColors.onSurface`、标语为 `AppColors.muted`;
- 静态检查 `splash_background` 为 `#FFF8F0`;
- `dart analyze lib test` 零告警 + `flutter test` 全过 + `flutter build apk --debug`。
**流程**:从 `develop` 拉 `fix/ios-k57-video-flash`;作者 `Zhou Weidong <502333560@qq.com>`;`--no-ff` 合回 develop 并 push;PROGRESS 留痕;iOS 复现由用户执行(把 `player-debug-video` 的文案发回来即可定位视频源问题)。
**流程**:从 `develop` 拉 `feature/flutter-k58-light-splash`;作者 `Zhou Weidong <502333560@qq.com>`;`--no-ff` 合回 develop 并 push;PROGRESS 留痕;真机验收由用户执行。