test(mobile): integration suite against real backend on mumu

P3 Task 11 (WRITE & COMPILE phase; device run pending MuMu availability). - integration_test/p3_flow_test.dart: login -> album (zh+en) -> category -> invite -> enqueue 3 real JPEGs -> queue completed -> server history (sourceDeviceId) -> ov public API sees 3 -> hide via API + UI sync -> DIO fault-gate offline (waitingNetwork -> retry -> 4 completed) -> password change (session kept) -> relogin -> in-app locale smoke. - integration_test/p3_background_test.dart: IT_PHASE=prepare/verify spec for HOME-background continuation and force-stop kill-restart recovery (2 x ~14MB noise JPEGs give a deterministic mid-flight window). - helpers: dart-define config, fault-injecting DIO adapter, app harness (picker/notification/locale provider overrides), UI step library with live-binding polling (no pumpAndSettle). - scripts/run-mobile-it.sh: device detect (exit 2), backend ensure (compose + api/ov/worker/sync, exit 3), idempotent per-run user seed (no DB reset), APK build/install + adb push of testdata, phase 1 / --background phase 2 orchestration with server-side confirmed-count truth via curl. - services/api seed:it script (create-if-absent staff accounts). - debug-only network security config: cleartext HTTP permitted to 10.0.2.2/127.0.0.1/localhost only (release unaffected). - testdata: 3 x ~120KB + 2 x ~14MB generated JPEGs. Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-19 05:35:16 +08:00
parent 8f3966d7b5
commit fb3c278e50
18 changed files with 1409 additions and 3 deletions
@@ -0,0 +1,133 @@
+/// 集成测试 App 装配（P3 Task 11）。
+///
+/// 与生产 `lib/main.dart` 的差异【全部为有意注入点，登记为计划偏差】：
+/// - **选图替身**：`multiImagePickerProvider`/`singleImagePickerProvider`
+///   返回 ADB 推送到设备的小图路径——image_picker 的系统相册 UI 无法在
+///   instrumentation 下自动驱动（连拍经相机 UI 同理，统一走多选路径，
+///   入队后的 准备→队列→引擎→原生桥接→真实后端 链路完全真实）；
+/// - **通知权限 no-op**：避免首个入队动作弹出系统权限对话框卡住自动流
+///   （脚本端另做 `pm grant` 双保险）；
+/// - **语言固定 zh**：MuMu 系统语言不确定，固定后文案查找器才稳定
+///   （App 内切换的语义已由 Task 10 单测覆盖，本套件另做一次切换冒烟）；
+/// - **故障闸门**：ApiClient 的 dio adapter 包 [FaultGate]（断网场景）。
+library;
+
+import 'dart:io';
+
+import 'package:dio/dio.dart';
+import 'package:flutter/widgets.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:path/path.dart' as p;
+import 'package:photo_live/app/app.dart';
+import 'package:photo_live/app/locale_controller.dart';
+import 'package:photo_live/core/api_client.dart';
+import 'package:photo_live/core/config.dart';
+import 'package:photo_live/core/notification_permission.dart';
+import 'package:photo_live/features/uploads/enqueue.dart';
+
+import 'fault_gate.dart';
+import 'it_config.dart';
+
+/// 选图替身：持有「下一次相册动作返回的路径」，消费后清空（未暂存时
+/// 返回空=模拟用户取消，让调用方走取消分支而不是挂起）。
+class ItImagePicker {
+  List<String> _staged = const <String>[];
+
+  /// 暂存下一批返回路径。
+  void stage(List<String> paths) => _staged = paths;
+
+  List<String> consume() {
+    final paths = _staged;
+    _staged = const <String>[];
+    return paths;
+  }
+}
+
+/// 测试装配产物。
+class ItAppHarness {
+  ItAppHarness._(this.container, this.gate, this.picker);
+
+  /// App 根容器（持有全部覆写；测试经它读 taskStore/apiClient 等）。
+  final ProviderContainer container;
+
+  /// 断网故障闸门。
+  final FaultGate gate;
+
+  /// 选图替身。
+  final ItImagePicker picker;
+
+  /// 装配 App（不 runApp——由 testWidgets 内 pumpWidget 注入
+  /// UncontrolledProviderScope）。
+  static ItAppHarness create() {
+    ItConfig.assertValid();
+    final gate = FaultGate();
+    final picker = ItImagePicker();
+
+    final dio = Dio(
+      BaseOptions(
+        baseUrl: ApiConfig.baseUrl,
+        connectTimeout: const Duration(seconds: 10),
+        sendTimeout: const Duration(seconds: 60),
+        receiveTimeout: const Duration(seconds: 60),
+      ),
+    );
+    dio.httpClientAdapter = FaultInjectingHttpClientAdapter(
+      gate: gate,
+      inner: dio.httpClientAdapter,
+    );
+
+    final container = ProviderContainer(
+      overrides: [
+        localeSettingsProvider.overrideWith(
+          () => LocaleSettings(initial: AppLocaleChoice.zh),
+        ),
+        apiClientProvider.overrideWith((ref) {
+          final client = ApiClient(
+            sessionStore: ref.watch(sessionStoreProvider),
+            dio: dio,
+          );
+          ref.onDispose(() => client.close());
+          return client;
+        }),
+        multiImagePickerProvider.overrideWithValue(() async => picker.consume()),
+        singleImagePickerProvider.overrideWithValue(() async {
+          final paths = picker.consume();
+          return paths.isEmpty ? null : paths.first;
+        }),
+        notificationPermissionProvider.overrideWithValue(
+          NotificationPermission(isAndroid: false),
+        ),
+      ],
+    );
+    return ItAppHarness._(container, gate, picker);
+  }
+
+  /// 注入根组件（每个 testWidgets 开头调用）。
+  Widget appWidget() =>
+      UncontrolledProviderScope(container: container, child: const PhotoLiveApp());
+}
+
+/// 解析设备端可读的测试图片目录。
+///
+/// 优先 App 自有 files 目录（脚本经 `run-as` 拷入，无 SELinux/作用域存储
+/// 风险），回退 `/data/local/tmp`（adb push 的直读路径，多数模拟器可用）。
+/// 返回含全部 `it_*.jpg` 的目录路径；两个候选都为空时抛错（提示先跑脚本）。
+Future<String> resolveImageDir(String supportDirPath) async {
+  final candidates = <String>[
+    p.join(supportDirPath, 'photolive-it'),
+    ItConfig.sourceDir,
+  ];
+  for (final dir in candidates) {
+    final list = Directory(dir)
+        .listSync()
+        .whereType<File>()
+        .map((f) => p.basename(f.path))
+        .where((name) => name.startsWith('it_') && name.endsWith('.jpg'))
+        .toList();
+    if (list.isNotEmpty) return dir;
+  }
+  throw StateError(
+    '设备上找不到测试图片（已尝试 ${candidates.join('、')}）——'
+    '请先运行 scripts/run-mobile-it.sh（负责 adb push + run-as 拷贝）',
+  );
+}