Files
photo-live/apps/mobile
浅念 955f9b13c1 feat(mobile): upload queue ui and continuous capture page
Task 9 (P3 plan): queue tab replaces the stub, continuous capture page
enqueues per shot, album detail gains an upload FAB, and the upload
engine lifecycle is now bound to the login session.

- Engine scope: session account drives UploadEngine start/stop; wired
  from app boot, login success, logout, and 401 eviction. Tasks stay in
  the store across logout (accountId hard isolation).
- Queue tab: album x state x time filter bar, task rows with thumbnail,
  state chip, localized error copy, attempt count, per-row progress via
  a broadcast progress hub, state-dependent actions (re-pick retry,
  retryNow, cancel, delete), batch retry bar, 200ms-debounced live
  refresh from drift table updates.
- Capture page: camera preview via injected CaptureSource, one enqueue
  per shutter press, persistent album/category/badges overlay with a
  switch-only-affects-new-shots hint, gallery multi-pick, exit confirm
  while uploads are pending, permission-denied and init-failure views.
- POST_NOTIFICATIONS runtime permission via a small MethodChannel
  (photolive/permissions) + PermissionPlugin.kt: single runtime
  permission need, avoids permission_handler dependency; requested once
  on first enqueue, silent degradation when denied or unavailable.
- Album detail FAB: capture-and-upload / pick-from-gallery sheet.
- l10n: ~50 new keys in zh/en arbs; tests: +45 (filter matrix, engine
  scope lifecycle, permission gate, queue tab, capture page, FAB entry);
  existing page tests updated to inject session/task-store fakes.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-19 04:47:31 +08:00
..

photo_live(工作人员 App)

P3 Flutter App(Android 优先;iOS 目录已生成但本机不编译,见计划 G3 关口)。

环境

工具链不在 PATH,所有 Flutter/Dart 命令先 source 仓库根的环境脚本(Git Bash):

source scripts/flutter-env.sh   # 仓库根执行;含 PATH/JAVA_HOME/ANDROID_HOME 与国内 pub 镜像

常用命令

cd apps/mobile
flutter pub get        # 依赖
flutter gen-l10n       # l10n 生成(arb 在 lib/l10n/,模板 app_zh.arb)
flutter analyze        # 静态检查(要求 0 issue)
flutter test           # 单测 / widget 测试
flutter build apk --debug   # 产物 build/app/outputs/flutter-apk/app-debug.apk

MuMu 模拟器联调:

adb connect 127.0.0.1:16384   # 失败再试 5555 / 7555 / 21503
adb devices
adb install -r build/app/outputs/flutter-apk/app-debug.apk
adb shell am start -n com.photolive.photo_live/.MainActivity

结构

  • lib/app/:根组件、主题(Material 3)、locale provider 脚手架(Task 10 完成切换)
  • lib/pages/:login / home(相册、队列、设置三个 tab 的桩页面)
  • lib/l10n/:arb 与生成的 app_localizations*.dart(zh 模板 + en)
  • Android:minSdk 24 / targetSdk 36;INTERNET 权限在 main manifest(debug+release 生效)
  • iOS:Info.plist 含本地网络 ATS 例外(联调宿主回环;Android 侧对应 10.0.2.2)与相册/相机用途说明(zh+en)

说明

  • sqlite3_flutter_libs 解析到 0.6.0+eol(官方弃用桩:sqlite3 3.x 起经 Dart 原生构建钩子自带 SQLite,无需该包);Task 5 建 drift schema 时在模拟器上验证实际打包行为。
  • turbo/pnpm 天然不纳入本目录(无 package.json);移动端命令以上述手动方式执行。