docs(plans): 留痕 K62 安卓桌面图标资源
This commit is contained in:
1 parent
a755a5f657
commit
0de7436baf
2 files changed
+79
-25
No files matched your search
+51
-25
@@ -1,30 +1,56 @@
|
||||
## [已处理] 2026-10-20 | K61-A 修复进入详情页/播放列表时底部闪白(系统导航栏与底部弹层)(仅 App 端)
|
||||
# INBOX
|
||||
|
||||
**用户指令(2026-10-20,原文)**:
|
||||
> 「现在有个问题 在安卓端 点击短剧标题 进入详情 底部会闪一下白色 进入短剧播放列表底部也会闪一下白色」
|
||||
## [已处理] K62-A 提交安卓桌面图标资源改造
|
||||
|
||||
**根因(已定位)**
|
||||
1. `app.dart` 全局 `SystemUiOverlayStyle` 里 `systemNavigationBarColor: AppColors.bar`(#FFFDFB,近白),且未关闭 `systemNavigationBarContrastEnforced`。Android 15/16 强制 edge-to-edge 时,系统会在透明导航栏后绘制**默认白色对比遮罩**,页面切换/弹层动画的瞬间就露出这条白带;
|
||||
2. 详情页(ink #FFF8F0)与播放器(黑底)都没有覆盖导航栏颜色,弹层(选集列表)打开时导航栏仍是白色;
|
||||
3. `MaterialApp` 未约束 `BottomSheetThemeData`,`showModalBottomSheet` 动画首帧可能露出默认白色表面。
|
||||
### 背景
|
||||
|
||||
**口径(只改 Flutter,不动后端、不改接口)**
|
||||
1. 全局(`app.dart`):`SystemUiOverlayStyle.dark.copyWith(...)` 增加
|
||||
- `systemNavigationBarColor: AppColors.ink`
|
||||
- `systemNavigationBarDividerColor: Colors.transparent`
|
||||
- `systemNavigationBarContrastEnforced: false`
|
||||
- `statusBarColor: Colors.transparent`(保留)
|
||||
2. `MaterialApp.theme` 增加:
|
||||
- `bottomSheetTheme: BottomSheetThemeData(backgroundColor: Colors.transparent, modalBackgroundColor: Colors.transparent, surfaceTintColor: Colors.transparent)`
|
||||
3. 播放器(全屏与首页 feed):`PlayerPage` 外包 `AnnotatedRegion<SystemUiOverlayStyle>`,`systemNavigationBarColor: Colors.black`、`systemNavigationBarContrastEnforced: false`、浅色图标。
|
||||
4. 详情页:`AnnotatedRegion` 导航栏 `AppColors.ink`、对比遮罩关闭;`DramaDetailBottomBar` 区域不得出现白色底。
|
||||
5. 选集等底部弹层:打开期间导航栏颜色与弹层一致(`EpisodePickerSheet` 为 `AppColors.card`),并在弹层内使用 `SafeArea(bottom: true)`;关闭后恢复全局 ink。
|
||||
6. 不改任何数据/交互逻辑。
|
||||
安卓桌面图标此前使用「奶油色底 + 前景缩到 72% + inset 16%」的自适应图标配置,与设计源图
|
||||
`assets/icon/fruitshorts.png`(橙渐变 + 满版果篮 + 播放按钮)观感差距大:颜色发淡、元素偏小。
|
||||
已在本机重做全部图标资源并完成真机验证(应用信息页图标完整无裁切)。
|
||||
|
||||
**测试/门禁**
|
||||
- 新增:全局 overlay style 断言 `systemNavigationBarContrastEnforced == false`、`systemNavigationBarColor == AppColors.ink`;
|
||||
- 播放页黑底导航栏、详情页 ink 导航栏断言;
|
||||
- 抽查选集弹层打开时导航栏颜色为 card;
|
||||
- `dart analyze lib test` 零告警 + `flutter test` 全过 + `flutter build apk --debug`。
|
||||
### 当前工作区改动(ReelShort 仓库,develop 分支,未提交)
|
||||
|
||||
**流程**:从 `develop` 拉 `fix/flutter-k61-navbar-flash`;作者 `Zhou Weidong <502333560@qq.com>`;`--no-ff` 合回 develop 并 push;PROGRESS 留痕;真机验收由用户执行。
|
||||
修改:
|
||||
- `android/app/src/main/res/drawable-mdpi/ic_launcher_foreground.png`
|
||||
- `android/app/src/main/res/drawable-hdpi/ic_launcher_foreground.png`
|
||||
- `android/app/src/main/res/drawable-xhdpi/ic_launcher_foreground.png`
|
||||
- `android/app/src/main/res/drawable-xxhdpi/ic_launcher_foreground.png`
|
||||
- `android/app/src/main/res/drawable-xxxhdpi/ic_launcher_foreground.png`
|
||||
- `android/app/src/main/res/mipmap-mdpi/ic_launcher.png`
|
||||
- `android/app/src/main/res/mipmap-hdpi/ic_launcher.png`
|
||||
- `android/app/src/main/res/mipmap-xhdpi/ic_launcher.png`
|
||||
- `android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png`
|
||||
- `android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png`
|
||||
- `android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml`
|
||||
|
||||
新增:
|
||||
- `android/app/src/main/res/mipmap-mdpi/ic_launcher_background.png`
|
||||
- `android/app/src/main/res/mipmap-hdpi/ic_launcher_background.png`
|
||||
- `android/app/src/main/res/mipmap-xhdpi/ic_launcher_background.png`
|
||||
- `android/app/src/main/res/mipmap-xxhdpi/ic_launcher_background.png`
|
||||
- `android/app/src/main/res/mipmap-xxxhdpi/ic_launcher_background.png`
|
||||
|
||||
`ic_launcher.xml` 目标内容:
|
||||
|
||||
```xml
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
|
||||
<background android:drawable="@mipmap/ic_launcher_background"/>
|
||||
<foreground android:drawable="@drawable/ic_launcher_foreground"/>
|
||||
</adaptive-icon>
|
||||
```
|
||||
|
||||
### 任务
|
||||
|
||||
1. 从 `develop` 拉分支 `fix/android-launcher-icon`(当前工作区改动保留,直接带入分支)。
|
||||
2. 只提交上述 16 个资源文件,禁止 `git add -A`,禁止改动其它文件。
|
||||
3. 提交信息:`fix(android): 按设计源图重做桌面图标资源`。
|
||||
4. 门禁:`dart analyze lib test`、`flutter test`、`flutter build apk --debug` 全部通过。
|
||||
5. `--no-ff` 合并回 `develop` 并 push。
|
||||
6. 在 `FruitServer/docs/plans/PROGRESS.md` 留痕:分支名、commit、门禁结果。
|
||||
|
||||
### 约束
|
||||
|
||||
- 全程中文;作者 `Zhou Weidong <502333560@qq.com>`。
|
||||
- 不改 Dart 代码、不改其它资源。
|
||||
- 完成后停住,等待验收。
|
||||
Reference in new issue
Block a user