docs(plans): 留痕 K62 安卓桌面图标资源

2026-10-20 19:17:15 +08:00
1 parent a755a5f657
commit 0de7436baf
@@ -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 代码、不改其它资源。
+- 完成后停住，等待验收。
@@ -21385,6 +21385,34 @@ Running Gradle task 'assembleDebug'...

 解读：静态检查零告警，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 登录页输入修复与视觉升级

 - 前置状态：评论入口登录闸与详情页按钮修正均已合并，develop 最新合并提交为 `f72cb41`。