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,不动后端、不改接口)**
|
安卓桌面图标此前使用「奶油色底 + 前景缩到 72% + inset 16%」的自适应图标配置,与设计源图
|
||||||
1. 全局(`app.dart`):`SystemUiOverlayStyle.dark.copyWith(...)` 增加
|
`assets/icon/fruitshorts.png`(橙渐变 + 满版果篮 + 播放按钮)观感差距大:颜色发淡、元素偏小。
|
||||||
- `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. 不改任何数据/交互逻辑。
|
|
||||||
|
|
||||||
**测试/门禁**
|
### 当前工作区改动(ReelShort 仓库,develop 分支,未提交)
|
||||||
- 新增:全局 overlay style 断言 `systemNavigationBarContrastEnforced == false`、`systemNavigationBarColor == AppColors.ink`;
|
|
||||||
- 播放页黑底导航栏、详情页 ink 导航栏断言;
|
|
||||||
- 抽查选集弹层打开时导航栏颜色为 card;
|
|
||||||
- `dart analyze lib test` 零告警 + `flutter test` 全过 + `flutter build apk --debug`。
|
|
||||||
|
|
||||||
**流程**:从 `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 代码、不改其它资源。
|
||||||
|
- 完成后停住,等待验收。
|
||||||
@@ -21385,6 +21385,34 @@ Running Gradle task 'assembleDebug'...
|
|||||||
|
|
||||||
解读:静态检查零告警,444 条测试全部通过,debug APK 构建成功。工作区原有 `pubspec.lock` 变更未纳入本批提交。真机验收由用户执行。
|
解读:静态检查零告警,444 条测试全部通过,debug APK 构建成功。工作区原有 `pubspec.lock` 变更未纳入本批提交。真机验收由用户执行。
|
||||||
|
|
||||||
|
## 2026-10-20 ReelShort:K62-A 安卓桌面图标资源改造
|
||||||
|
|
||||||
|
- 前置状态:K61-A 已完成并合并,develop 合并提交 `51e9402`。
|
||||||
|
- 分支:`fix/android-launcher-icon`
|
||||||
|
- 功能提交:`4c8ae7b fix(android): 按设计源图重做桌面图标资源`
|
||||||
|
- develop 合并提交:`911f13f merge: 合并 K62 安卓桌面图标资源`,已推送。
|
||||||
|
- 按设计源图重做 Android 五档密度桌面图标、前景图和独立背景图,共提交 16 个资源文件(11 个修改、5 个新增)。
|
||||||
|
- `mipmap-anydpi-v26/ic_launcher.xml` 使用五档 `@mipmap/ic_launcher_background` 与 `@drawable/ic_launcher_foreground` 自适应图标组合,不再使用旧 inset/72% 缩放配置。
|
||||||
|
- 未修改 Dart 代码、启动图或其它资源;未使用 `git add -A`,未夹带无关文件。
|
||||||
|
|
||||||
|
门禁原始输出:
|
||||||
|
|
||||||
|
```text
|
||||||
|
$ dart analyze lib test
|
||||||
|
Analyzing lib, test...
|
||||||
|
No issues found!
|
||||||
|
|
||||||
|
$ flutter test
|
||||||
|
00:54 +473: All tests passed!
|
||||||
|
|
||||||
|
$ flutter build apk --debug
|
||||||
|
Running Gradle task 'assembleDebug'...
|
||||||
|
10.5s
|
||||||
|
✓ Built build/app/outputs/flutter-apk/app-debug.apk
|
||||||
|
```
|
||||||
|
|
||||||
|
解读:静态检查零告警,473 条测试全部通过,debug APK 构建成功。安卓桌面图标改造等待用户真机验收。
|
||||||
|
|
||||||
## 2026-10-20 ReelShort:K41-A 登录页输入修复与视觉升级
|
## 2026-10-20 ReelShort:K41-A 登录页输入修复与视觉升级
|
||||||
|
|
||||||
- 前置状态:评论入口登录闸与详情页按钮修正均已合并,develop 最新合并提交为 `f72cb41`。
|
- 前置状态:评论入口登录闸与详情页按钮修正均已合并,develop 最新合并提交为 `f72cb41`。
|
||||||
|
|||||||
Reference in new issue
Block a user