docs(plans): 留痕 K53 详情页首帧修复

This commit is contained in:
Zhou Weidong committed 2026-10-20 17:54:52 +08:00
1 parent a38809cc5d
commit e50e6c7170
2 files changed
+45 -13

No files matched your search

+17 -13
View File
@@ -1,20 +1,24 @@
## [已处理] 2026-10-20 | K52-A 去掉原生静态开屏,直接进入带动画的开屏页(仅 App 端)
## [已处理] 2026-10-20 | K53-A 详情页首帧直出内容,去掉「先空白背景再出内容」(仅 App 端)
**用户指令(2026-10-20,原文)**:
> 「原生的开屏也就不要了 直接显示带动画效果的开屏页即可」
> 「现在从首页的短剧标题点进去仍然会闪屏 先显示详情页背景色 然后才显示内容 还是没有修改好」
**口径(只改 Flutter / 原生启动资源,不动后端、不改接口)**
1. Android 原生开屏只保留纯色底:
- `android/app/src/main/res/drawable/launch_background.xml`、`drawable-v21/launch_background.xml`、`drawable-v31/launch_background.xml` 全部改为仅 `@color/splash_background`(去掉 bitmap / splash_icon 图层);
- `values-v31/styles.xml` 与 `values-night-v31/styles.xml`:`windowSplashScreenAnimatedIcon` 改为透明 drawable(新增 `drawable/splash_transparent.xml`,`<shape><solid android:color="@android:color/transparent"/></shape>`),移除 `windowSplashScreenIconBackgroundColor`;
- `splash_background` 保持 `#100C0A`,与 Flutter 动画开屏背景一致,避免色差。
2. iOS 原生开屏去掉静态图:
- `ios/Runner/Base.lproj/LaunchScreen.storyboard` 删除 `LaunchImage` imageView 及其 constraints,仅保留深色背景(现 rgb 0.0627/0.0470/0.0392)。
3. Flutter 动画开屏页保持 K50-A 的动画(logo 放大淡入 → FruitShorts → 水果短剧 → 转圈),作为用户看到的第一个画面;原生只做纯色过渡。
4. 不再引用 `drawable-*/splash_icon.png` 与 iOS `LaunchImage`(文件可保留,但不得出现在启动界面)。
**根因(已定位)**
`drama_detail_view.dart` 的 `_page()` 第一行是 `if (logic.loading) return _loading(l10n);`:即便是从首页卡片进入(标题、封面、简介、数据都已具备),详情接口未返回前整页被替换成「ink 背景 + AppBar + 转圈」的空白页;接口返回后才渲染真正内容 → 表现为「先闪一下底色,再出内容」。
**口径(只改 Flutter,不动后端、不改接口)**
1. 首帧直出:`_page()` 不再因 `logic.loading` 整页 loading;直接用 `logic.drama`(初始即传入的卡片数据)渲染 Header / 数据卡 / 简介 / 标签。
2. 选集区按需加载:
- `drama.episodes.isEmpty && logic.loading` → 选集区显示 6 个骨架格(1:1 圆角块 + 轻微呼吸),Key `detail-episodes-loading`;
- 详情失败 → 选集区显示「加载失败 + 重试」,Key `detail-episodes-retry`,页面其它内容不受影响;
- 详情成功 → 正常渲染选集网格。
3. 仅当传入卡片本身没有可用内容(标题与封面都为空)时,才允许整页 loading/失败页;现有 `detail-error` 等 Key 保留给该场景。
4. 底部 CTA 在选集未加载时禁用(灰态)并显示 `startWatching`,详情到达后恢复可点。
5. 不改 `openDetail` 的跳转方式(K51-A 已改)。
**测试/门禁**
- 静态检查:三个 `launch_background.xml` 不再包含 bitmap;v31 styles 不含 `windowSplashScreenIconBackgroundColor`;LaunchScreen.storyboard 不含 `LaunchImage`;
- 新增:进入详情页首帧即可看到 `detail-title`、`detail-poster`、`detail-stats`,且不存在整页 `CircularProgressIndicator`;
- 详情加载中选集区显示 `detail-episodes-loading`;失败显示 `detail-episodes-retry` 且标题仍在;
- `dart analyze lib test` 零告警 + `flutter test` 全过 + `flutter build apk --debug`。
**流程**:从 `develop` 拉 `feature/flutter-k52-native-splash-clean`;作者 `Zhou Weidong <502333560@qq.com>`;`--no-ff` 合回 develop 并 push;PROGRESS 留痕;真机验收由用户执行(冷启动应看到纯深色 → Flutter 动画开屏)。
**流程**:从 `develop` 拉 `fix/flutter-k53-detail-first-frame`;作者 `Zhou Weidong <502333560@qq.com>`;`--no-ff` 合回 develop 并 push;PROGRESS 留痕;真机验收由用户执行。