浅念
42e1c2e34b
Swift 侧（协议与 Android UploadPlugin.kt 逐字一致，编译/真机留 G3）： - UploadBridge.swift：通道/方法/事件/失败码常量 + registerTask 参数解析 （镜像 UploadProtocol.kt） - UploadEventBus.swift：单调 seq + 终态 ack 缓存重放（镜像 UploadEventBus.kt），iOS 增强——未 ack 终态落盘（系统后台拉起投递的 回调在进程重启后同样重放，技术方案 §6.2 持久化原生回调） - UploadTaskStore.swift：taskId→URLSession taskIdentifier 映射 plist 持久化 （Application Support；对应 Android WorkManager 自持映射） - UploadPlugin.swift：URLSession background （com.photolive.photo_live.uploads）+ delegate 失败分类（2xx→completed+etag / 403→needsRenew / 4xx→HTTP_4XX / 网络→重试上限后 NETWORK，镜像 UploadPutExecutor/UploadWorker）、原生重试（5 次上限、10s 指数退避）、 进度 500ms 节流、queryTask/cancelTask/ackEvents、静默取消 - AppDelegate.swift：implicit engine 通道注册 + 启动重建会话 + handleEventsForBackgroundURLSession completionHandler 暂存 - Info.plist：UIBackgroundModes 有意不声明（background URLSession 无需； 计划措辞按技术方案 §6.2 修正，见 README-ios.md） - project.pbxproj 登记新 Swift 文件；README-ios.md（Xcode 步骤 + G3 验证 清单：实际文件上传/持久化回调窗口/服务端补偿/重启重联校准/强制退出/ 低电量延迟/100 张批量） Dart：NativeTransport 选择矩阵并入 iOS（Platform.isAndroid || isIOS， FORCE_DART_TRANSPORT 覆盖不变）——协议两侧一致，无新通道代码。 flutter analyze 0 issue；flutter test 219 全绿。 Co-Authored-By: Claude Code <noreply@anthropic.com>
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（官方弃用桩：sqlite33.x 起经 Dart 原生构建钩子自带 SQLite，无需该包）；Task 5 建 drift schema 时在模拟器上验证实际打包行为。- turbo/pnpm 天然不纳入本目录（无 package.json）；移动端命令以上述手动方式执行。