Files
jiu/client/lib/core/utils/print_util.dart
T
wangjia d67295234e refactor(client): 抽声明式 LabelTemplate 单源,价签渲染改读模型(P0)
价签版式原 100% 硬编码在四条渲染路径。引入 label_template.dart
声明式模型(纸张/打印/抬头/文字栈/QR/条码),builtinDefault() 逐值冻结
重构前常量;画布渲染器 _renderLabelBitmap 与热敏 _printFlatLabelThermal
改为纯读模型,坐标统一到画布权威。facade/web stub 加 template 可选参
(null→默认,现有调用点行为不变)。

新增 label_render_golden 零回归基准:默认模板渲染与重构前逐像素零 diff。
附评审通过的设计文档 label-template-editor.html(5 项决策)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Bupi8Kdqkfx2N5acFsHTx5
2026-08-29 00:00:13 +08:00

87 lines
2.8 KiB
Dart

import 'dart:typed_data';
import 'package:flutter/material.dart';
import '../../models/stock_in.dart';
import '../../models/stock_out.dart';
import '../errors/error_reporter.dart';
import 'label_data.dart';
export 'label_data.dart';
import 'label_template.dart';
export 'label_template.dart';
import 'order_print_meta.dart';
import '../theme/context_tokens.dart';
import '../../widgets/ds/ds_toast.dart';
export 'order_print_meta.dart';
import 'print_util_stub.dart'
if (dart.library.js_interop) 'print_util_web.dart';
Future<void> printProductLabel({
required Uint8List qrBytes,
required String name,
required String code,
String? spec,
String? series,
String? batchNo,
String? productionDate,
String? remark,
String shopName = '',
String shopAddress = '',
String shopPhone = '',
String? printerName,
LabelTemplate? template,
}) =>
printProductLabelImpl(
qrBytes: qrBytes,
name: name,
code: code,
spec: spec,
series: series,
batchNo: batchNo,
productionDate: productionDate,
remark: remark,
shopName: shopName,
shopAddress: shopAddress,
shopPhone: shopPhone,
printerName: printerName,
template: template,
);
/// 渲染标签预览图(PNG 字节);Web 平台返回 null。
Future<Uint8List?> renderLabelPreview(LabelData label,
{LabelTemplate? template}) =>
renderLabelPreviewImpl(label, template: template);
/// 枚举当前系统所有可用打印机名;Web 平台返回空列表。
Future<List<String>> listLabelPrinters() => listLabelPrintersImpl();
/// 自动检测默认热敏打印机(名字含 deli/dl-888);找不到或 Web 返回 null。
Future<String?> detectDefaultPrinter() => detectDefaultPrinterImpl();
Future<void> printStockInOrder(StockInOrder order, OrderPrintMeta meta) =>
printStockInOrderImpl(order, meta);
Future<void> printStockOutOrder(StockOutOrder order, OrderPrintMeta meta) =>
printStockOutOrderImpl(order, meta);
/// 生成入库单 PDF 字节(桌面端真实排版,供打印预览光栅化用);Web 端不支持。
Future<Uint8List> buildStockInOrderPdf(
StockInOrder order, OrderPrintMeta meta) =>
buildStockInOrderPdfImpl(order, meta);
/// 生成出库单 PDF 字节(桌面端真实排版,供打印预览光栅化用);Web 端不支持。
Future<Uint8List> buildStockOutOrderPdf(
StockOutOrder order, OrderPrintMeta meta) =>
buildStockOutOrderPdfImpl(order, meta);
/// 统一打印入口:catch 任意异常,上报并弹 SnackBar 给用户。
/// 用法:await safePrint(context, () => printStockInOrder(order));
Future<void> safePrint(BuildContext context, Future<void> Function() fn) async {
try {
await fn();
} catch (e, st) {
reportError(e, st);
if (context.mounted) {
showDsToast(context, '打印失败:$e', bg: context.tokens.danger);
}
}
}