Files
photo-live/apps/mobile
浅念 d96e56f653 feat(mobile): drift upload task store with state machine
- upload_tasks 表(accountId 隔离 + 三个复合索引)、状态列枚举转换器、
  datetime 文本落库(UTC 归一,亚秒精度)
- 纯状态机(task_state.dart):合法迁移表 + canTransition/assertTransition,
  completed/cancelled 终态
- TaskStore 仓储:create(clientTaskId 同账号同相册应用侧唯一)、
  updateState(迁移守护+旁路字段)、账号隔离读路径(硬守护)、
  countsByState 徽章、cleanupCandidates/markCleanable(仅终态可清理——
  评审缺口 1 硬守护,未完成源文件永不清理)
- 测试 26 例(状态机表驱动全边 + 守护/隔离/筛选/保留策略);
  sqlite3 3.x build hooks 在 flutter test 宿主与 Android APK 构建均验证
  (libsqlite3.so 已打包全 ABI,运行时验证留 Task 11)

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-19 02:12:39 +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);移动端命令以上述手动方式执行。