wangjia
243b37e81d
- 打包 Noto Sans SC（pubspec fonts:），ThemeData.fontFamily 全平台统一 - golden_harness 用 FontLoader 注入 ttf + withGoldenFont，golden 渲染真实中文 - 修复 data_table_card 根因：DefaultTextStyle → .merge（替换式会吞掉继承字体， 导致所有表格屏表头/单元格渲染豆腐块）；顺手 hover 硬编码色 → context.tokens.rowHover - 全部 golden 用新字体重生成；test/golden/failures/ 加入 gitignore Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TSKEiHsvauyxYUW2itzUXX
89 lines
3.2 KiB
Dart
89 lines
3.2 KiB
Dart
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<void> ensureGoldenFonts() async {
|
||
if (_fontsLoaded) return;
|
||
final loader = FontLoader('NotoSansSC')
|
||
..addFont(rootBundle.load('assets/fonts/NotoSansSC.ttf'));
|
||
await loader.load();
|
||
_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/<x>_golden_test.dart
|
||
///
|
||
/// 坑（详见 reference）：viewport 逻辑尺寸 = physical ÷ dpr（已按 logical*dpr 设好）；
|
||
/// 高度给足防 RenderFlex 溢出；测试无中文字体 → CJK 显示豆腐块属正常。
|
||
Future<void> pumpGolden(
|
||
WidgetTester tester, {
|
||
required Widget child,
|
||
required String theme,
|
||
required String goldenName,
|
||
List<Override> 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<Override> 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,
|
||
);
|
||
});
|
||
}
|
||
}
|