d67295234e
价签版式原 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
87 lines
2.8 KiB
Dart
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);
|
|
}
|
|
}
|
|
}
|