import 'package:flutter/material.dart'; import 'package:flutter/services.dart' show rootBundle, FontLoader; import 'package:flutter_riverpod/flutter_riverpod.dart'; import 'package:flutter_test/flutter_test.dart'; import 'package:jiu_client/core/theme/themes.dart'; // 加载真实中文字体(消除 golden 豆腐块),使 golden 能与原型截图做保真 diff。 // 原型截图侧同样注入 Noto Sans SC(见 tools/fidelity.mjs),两边字体一致。 bool _fontsLoaded = false; Future ensureGoldenFonts() async { if (_fontsLoaded) return; final loader = FontLoader('NotoSansSC') ..addFont(rootBundle.load('assets/fonts/NotoSansSC.ttf')); await loader.load(); // 等宽真相源 JetBrainsMono(AppFonts.mono;400+700)——与原型截图注入、 // 真机打包同一字体文件,等宽渲染三方同源(未加载会渲染成黑块 tofu)。 final mono = FontLoader('JetBrainsMono') ..addFont(rootBundle.load('assets/fonts/JetBrainsMono-Regular.ttf')) ..addFont(rootBundle.load('assets/fonts/JetBrainsMono-Bold.ttf')); await mono.load(); // 真实 Material 图标字体(否则 golden 里图标渲染成豆腐块 □)。 for (final key in const [ 'fonts/MaterialIcons-Regular.otf', 'packages/flutter/fonts/MaterialIcons-Regular.otf', ]) { try { final f = FontLoader('MaterialIcons')..addFont(rootBundle.load(key)); await f.load(); break; } catch (_) {/* 换下一个 asset key */} } // lucide 图标字体(与原型同款图形库)。 try { // package 字体在运行时 family 带 packages// 前缀,FontLoader 须用全名。 final lucide = FontLoader('packages/lucide_icons_flutter/Lucide') ..addFont( rootBundle.load('packages/lucide_icons_flutter/assets/lucide.ttf')); await lucide.load(); } catch (_) {/* 包未装时跳过 */} _fontsLoaded = true; } /// 把 NotoSansSC 套到主题文字上(含 hardcoded TextStyle 经 DefaultTextStyle 继承)。 ThemeData withGoldenFont(ThemeData base) => base.copyWith( textTheme: base.textTheme.apply(fontFamily: 'NotoSansSC'), primaryTextTheme: base.primaryTextTheme.apply(fontFamily: 'NotoSansSC'), ); /// 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 { await ensureGoldenFonts(); 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: withGoldenFont(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, ); }); } }