APP图标更新

2026-09-22 14:50:04 +08:00
parent 67d4dd5b7c
commit a6e02ccbf3
36 changed files with 190 additions and 148 deletions
@@ -284,26 +284,72 @@ version: 1.0.0+1

 ### 7.3 应用名称与图标

-| 项 | 位置 | 当前值 |
+**应用名称**（已配置好，改名字动这几处）：
+
+| 平台 | 位置 | 当前值 |
 |---|---|---|
-| 应用名 | `android/app/src/main/AndroidManifest.xml` 的 `android:label` | `qiangbao_accounting` |
-| 图标 | `android/app/src/main/res/mipmap-*/ic_launcher.png` | Flutter 默认图标 |
+| Android 桌面名 | `android/app/src/main/AndroidManifest.xml` 的 `android:label` | `强宝爱记账` |
+| iOS 桌面名 | `ios/Runner/Info.plist` 的 `CFBundleDisplayName` | `强宝爱记账` |
+| Web 标签页 | `web/index.html` 的 `<title>` | `强宝爱记账` |
+| Web 主屏名 | `web/index.html` 的 `apple-mobile-web-app-title` | `强宝爱记账` |
+| Web PWA | `web/manifest.json` 的 `name` / `short_name` | `强宝爱记账` / `强宝记账` |
 | 包名 | `android/app/build.gradle.kts` 的 `applicationId` | `com.qiangbao.qiangbao_accounting`（**上架后不可改**） |

-图标推荐用 `flutter_launcher_icons` 一键生成：
+> `short_name` 保持 4 个汉字以内，否则 Android 桌面图标下方会被截断成省略号。
+> 改完名字必须**重新构建 + 安装**；若桌面名称没刷新，先卸载旧包再装（启动器缓存）。
+> 应用商店里显示的名称在 Google Play / App Store 后台配置，代码里改不了。
+
+**App 图标**（已配置好，链路如下）：
+
+素材分级存放，`assets/icon/` 未被 pubspec 声明为资源，不会打进包体积：
+
+| 文件 | 作用 |
+|---|---|
+| `assets/icon/_source/raw_bear.png` | 图标素材原图（1024×1024，AI 生成，带水印） |
+| `assets/icon/_source/raw_bear_dog.png` | 备选素材（熊 + 金毛），想换风格可用 |
+| `assets/icon/app_icon.png` | 脚本产物：纯净版图标，无透明通道 |
+| `assets/icon/app_icon_fg.png` | 脚本产物：Android 自适应图标前景层，透明底 |
+
+完整生成链路（改图标只需重跑这两条）：
+
+```bash
+python tools/make_app_icon.py     # 去水印 + 抠图 + 居中缩放 → assets/icon/app_icon*.png
+dart run flutter_launcher_icons   # 铺开成 Android / iOS / Web 全部尺寸
+```
+
+`tools/make_app_icon.py` 的辅助参数：
+
+```bash
+python tools/make_app_icon.py --preview   # 输出效果预览图 tools/_preview.png
+python tools/make_app_icon.py --check     # 核对产物色彩模式（iOS 必须 RGB 无 alpha）
+python tools/make_app_icon.py --src <路径> # 换用其它素材图
+```
+
+配置在 `pubspec.yaml` 末尾的 `flutter_launcher_icons` 段：
+
 ```yaml
-# pubspec.yaml
-dev_dependencies:
-  flutter_launcher_icons: ^0.14.0
 flutter_launcher_icons:
  android: true
  ios: true
-  image_path: "assets/images/logo.png"
-```
-```bash
-dart run flutter_launcher_icons
+  image_path: "assets/icon/app_icon.png"          # iOS / 传统 Android / Web
+  adaptive_icon_background: "#FFF6EC"             # Android 8+ 背景层
+  adaptive_icon_foreground: "assets/icon/app_icon_fg.png"  # 前景层
+  remove_alpha_ios: true                          # iOS 不允许透明，否则上架报 ITMS-90717
+  web:
+    generate: true
 ```

+产物落点：
+
+| 平台 | 产物 |
+|---|---|
+| Android 传统 | `res/mipmap-{m,h,xh,xxh,xxxh}dpi/ic_launcher.png`（48/72/96/144/192） |
+| Android 自适应 | `res/mipmap-anydpi-v26/ic_launcher.xml` + `res/values/colors.xml` + `res/drawable-*/ic_launcher_foreground.png` |
+| iOS | `ios/Runner/Assets.xcassets/AppIcon.appiconset/` 全套 22 张 |
+| Web | `web/icons/Icon-{192,512}.png`、`Icon-maskable-{192,512}.png`、`web/favicon.png` |
+
+> **不要把 `assets/images/logo.png` 当图标用**：它是登录页的贴纸海报（非正方形、带虚化底纹、含 5 个大字），缩到 48px 会糊成一团，且背景去不干净。图标必须是「单一主体 + 简洁轮廓」。
+
 ---

 ## 8. 本项目已做的环境配置（请勿改回）