Flutter热敏打印机控制插件esc_pos_printer_th的使用

该库允许使用ESC/POS热敏WiFi/以太网打印机打印收据。对于蓝牙打印机，请使用esc_pos_bluetooth库。

它可以在Flutter或纯Dart项目中使用。对于Flutter项目，同时支持Android和iOS平台。

要扫描网络中的打印机，可以考虑使用ping_discover_network包。请注意，大多数ESC/POS打印机默认监听9100端口。

TODO（欢迎PR！）

• 使用GS ( k命令打印QR码（从图像打印QR码已支持）
• 使用GS ( k命令打印PDF-417条形码
• 使用ESC 3 <n>命令设置行间距

如何帮助

• 测试你的打印机并添加到表格中：WiFi/网络打印机 或 蓝牙打印机
• 测试并报告错误
• 分享你对改进的看法（代码优化、新功能等）
• PRs欢迎！

已测试的打印机

以下是一些使用此库测试过的打印机。请添加你测试过的模型以维护和改进此库，并帮助他人选择合适的打印机。

生成收据

简单带样式的收据

void testReceipt(NetworkPrinter printer) {
  printer.text(
        'Regular: aA bB cC dD eE fF gG hH iI jJ kK lL mM nN oO pP qQ rR sS tT uU vV wW xX yY zZ');
  printer.text('Special 1: àÀ èÈ éÉ ûÛ üÜ çÇ ôÔ',
      styles: PosStyles(codeTable: 'CP1252'));
  printer.text('Special 2: blåbærgrød',
      styles: PosStyles(codeTable: 'CP1252'));

  printer.text('Bold text', styles: PosStyles(bold: true));
  printer.text('Reverse text', styles: PosStyles(reverse: true));
  printer.text('Underlined text',
      styles: PosStyles(underline: true), linesAfter: 1);
  printer.text('Align left', styles: PosStyles(align: PosAlign.left));
  printer.text('Align center', styles: PosStyles(align: PosAlign.center));
  printer.text('Align right',
      styles: PosStyles(align: PosAlign.right), linesAfter: 1);

  printer.text('Text size 200%',
      styles: PosStyles(
        height: PosTextSize.size2,
        width: PosTextSize.size2,
      ));

  printer.feed(2);
  printer.cut();
}

你可以在这里找到更多例子。

打印收据

import 'package:esc_pos_printer_th/esc_pos_printer_th.dart';

const PaperSize paper = PaperSize.mm80;
final profile = CapabilityProfile.load();
final printer = NetworkPrinter(paper, profile);

final PosPrintResult res = await printer.connect('192.168.0.123', port: 9100);

if (res == PosPrintResult.success) {
  testReceipt(printer);
  printer.disconnect();
}

print('Print result: ${res.msg}');

完整的示例请查看example/example.dart 和 example/discover_printers。

测试打印

import 'package:esc_pos_printer_th/esc_pos_printer_th.dart';
import 'package:flutter/material.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const HoweScreen(),
    );
  }
}

class HoweScreen extends StatefulWidget {
  const HoweScreen({super.key});

  [@override](/user/override)
  State<HoweScreen> createState() => _MyWidgetState();
}

class _MyWidgetState extends State<HoweScreen> {
  late NetworkPrinter printer;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const Placeholder();
  }
}