APP图标更新
This commit is contained in:
@@ -14,7 +14,8 @@
|
||||
- UI：Material 3（Flutter 3.16+ 默认启用），未显式设置 `useMaterial3`。
|
||||
|
||||
## 架构与关键文件
|
||||
- `lib/app.dart`：根组件 `QiangbaoApp extends ConsumerWidget`。定义全局 `navigatorKey`（供网络层 401 跳转登录页），配置主题，用 `auth.isLoggedIn` 在 `MainShell` / `LoginPage` 之间分发。
|
||||
- `lib/app.dart`：根组件 `QiangbaoApp extends ConsumerWidget`。配置 M3 主题，用 `auth.isLoggedIn` 在 `MainShell` / `LoginPage` 之间分发。全局 `navigatorKey` 已抽到 `lib/core/navigation/navigator_key.dart`（避免 app.dart ↔ 网络层循环依赖），供网络层 401 跳转与全局 toast 使用。
|
||||
- `lib/core/network/auth_redirect.dart`：网络层与 Riverpod 的桥接（`configureAuthRedirect(container)` 在 `main.dart` 调用），提供 `forceLogout()` / `logoutAndGoLogin()`。
|
||||
- `lib/pages/shell/main_shell.dart`：主框架，4 个 Tab（首页/记账/统计/我的），用 `IndexedStack` 保留各页状态，`NavigationBar`（M3）承载导航，默认 `_index = 1`（记账）。`initState` 里有登录态兜底跳转。
|
||||
- `lib/pages/login/login_page.dart`：登录/注册页，含毛玻璃卡片（`BackdropFilter`）、动画背景圆球（`AnimationController` + `Stack` + `Positioned` + `Transform.translate`）、记住密码（`utils/crypto.dart` 加解密）。
|
||||
- 目前只有「记账」页（`AddPage`，含 `manual_entry_tab.dart`、`ocr_tab.dart`、`ocr_result_card.dart`）是真实实现，首页/统计/我的仍是 `_PlaceholderPage`。
|
||||
@@ -25,12 +26,30 @@
|
||||
- 登录页另用暖橙渐变 `#FFE5CC → #FFD4A8 → #FFC08A`，点缀金色 `#FFD700`、粉色 `#FFB6C1`。
|
||||
- 注意：项目中颜色多为**硬编码字面量**，尚未统一走 `Theme.of(context).colorScheme`（有优化空间）。
|
||||
|
||||
## 网络环境配置（重要）
|
||||
- 环境切换在 `lib/core/network/api_env.dart`：`baseUrl` 三级优先级 = `--dart-define=API_BASE_URL` > `!kDebugMode` 取 `kProdBaseUrl` > `kLocalBaseUrl`。
|
||||
- 消费链：`dio_client.dart` 的 `dioProvider` → `BaseOptions.baseUrl`；API 层使用相对路径（如 `/auth/login`）。
|
||||
- 生产地址当前为 `http://103.36.220.231:12345/api`（明文 HTTP + 裸 IP）。**与注释及 `docs/Flutter打包与真机安装指南.md` 中记录的 `https://accounting.aqroid.cn/api` 不一致。**
|
||||
- `ios/Runner/Info.plist` 无任何 ATS 例外配置 → iOS 包请求 http 会被拦截。
|
||||
- `android/app/src/main/AndroidManifest.xml` 已设 `android:usesCleartextTraffic="true"`。
|
||||
- 已知风险：① `--dart-define` 在 release 下同样生效，可击穿"正式包走生产"的保证；② `kDebugMode` 在 profile 模式为 false → profile 包会连生产，宜改用 `kReleaseMode`。
|
||||
|
||||
## 待办 / 可优化点
|
||||
- 硬编码颜色可迁移为 M3 角色色（`colorScheme.primary` 等），并补暗色模式。
|
||||
- `api_env.dart` 优先用 `kReleaseMode` 显式判断，并统一生产地址（域名 + HTTPS）；多环境改用 `--dart-define-from-file`；加运行时自检/启动日志显示当前 baseUrl。
|
||||
- iOS 若需访问明文 HTTP，需在 `Info.plist` 增加 ATS 例外（`NSAllowsLocalNetworking` 或域例外）。
|
||||
- `MainShell` 未做响应式：宽屏（≥600dp/840dp）应切换 `NavigationRail` / `NavigationDrawer`。
|
||||
- `MainShell.initState` 的 `addPostFrameCallback` 回调里可加 `if (!mounted) return;`。
|
||||
- Flutter 3.47 起 Material/Cupertino 已解耦为 `material_ui` / `cupertino_ui` 包，`package:flutter/material.dart` 仍可用，暂无需迁移。
|
||||
|
||||
## 应用名称与图标（已落地）
|
||||
- 显示名统一为 **强宝爱记账**：`AndroidManifest.xml` 的 `android:label`、`Info.plist` 的 `CFBundleDisplayName`、`web/index.html` 的 `<title>` 与 `apple-mobile-web-app-title`；`web/manifest.json` 用 `short_name = 强宝记账`（4 字以内避免桌面截断）。
|
||||
- 图标链路：`tools/make_app_icon.py`（去水印 + 抠图 + 缩放）→ `assets/icon/app_icon.png` + `app_icon_fg.png` → `dart run flutter_launcher_icons`。
|
||||
- 图标配置在 `pubspec.yaml` 末尾的 `flutter_launcher_icons` 段；dev 依赖已加 `flutter_launcher_icons: ^0.14.0`。
|
||||
- 素材归档在 `assets/icon/_source/`（`raw_bear.png` 采用、`raw_bear_dog.png` 备选）。`assets/icon/` 未声明为 Flutter assets，不会进包。
|
||||
- **`assets/images/logo.png`（1120×928 贴纸海报）不可用作图标**：非正方形、带虚化底纹、含大字，48px 下不可读。
|
||||
- 改图标 = 重跑上面两条命令；改名字后需卸载重装才刷新桌面。
|
||||
|
||||
## 用户画像与偏好
|
||||
- 用户正在**系统学习 Flutter 基础概念**，常就单个文件/代码片段提问（如 `GlobalKey`、`ConsumerWidget`、`ref`、`Stack`）。
|
||||
- 沟通偏好：希望用**中文**解释，讲清「是什么 + 为什么这么写 + 在本项目中的上下文」，并配合结构化的表格/分层说明。
|
||||
|
||||
Reference in New Issue
Block a user