import 'package:flutter/material.dart'; import 'package:flutter_riverpod/flutter_riverpod.dart'; import 'package:flutter_test/flutter_test.dart'; import 'package:jiu_client/core/theme/themes.dart'; /// design-distill 阶段4(Flutter 端)可复用 golden 骨架。 /// 在指定主题 / viewport 下渲染 [child](含 provider 覆盖),比对/更新 golden。 /// /// 验收分两类闸(见 ~/.claude/skills/design-distill/references/flutter-golden.md): /// - 保真:原型基准 vs 本 golden 用 montage.mjs 人工目检(跨渲染器,不跑严格 diff)。 /// - 回归:本 golden 多主题入库,CI `flutter test` 同渲染器自比抓串色/漏 token。 /// /// 更新基准:flutter test --update-goldens test/golden/_golden_test.dart /// /// 坑(详见 reference):viewport 逻辑尺寸 = physical ÷ dpr(已按 logical*dpr 设好); /// 高度给足防 RenderFlex 溢出;测试无中文字体 → CJK 显示豆腐块属正常。 Future pumpGolden( WidgetTester tester, { required Widget child, required String theme, required String goldenName, List overrides = const [], Size logical = const Size(1280, 900), double dpr = 2.0, }) async { tester.view.physicalSize = Size(logical.width * dpr, logical.height * dpr); tester.view.devicePixelRatio = dpr; addTearDown(tester.view.resetPhysicalSize); addTearDown(tester.view.resetDevicePixelRatio); await tester.pumpWidget(ProviderScope( overrides: overrides, child: MaterialApp( debugShowCheckedModeBanner: false, theme: buildTheme(theme), home: child, ), )); await tester.pumpAndSettle(); await expectLater( find.byType(MaterialApp), matchesGoldenFile('goldens/$goldenName.png'), ); } /// 跑「同一 child × A/B/C 三主题」的 golden 组(回归闸常用)。 void goldenAcrossThemes( String description, { required Widget Function() child, required String goldenPrefix, List Function()? overrides, Size logical = const Size(1280, 900), double dpr = 2.0, }) { for (final theme in const ['a', 'b', 'c']) { testWidgets('$description · theme $theme', (tester) async { await pumpGolden( tester, child: child(), theme: theme, goldenName: '${goldenPrefix}_$theme', overrides: overrides?.call() ?? const [], logical: logical, dpr: dpr, ); }); } }