Flutter直接打印插件directprint的使用

directprint 插件允许Flutter应用程序通过Windows系统的OpenPrinter/StartDocPrinter函数直接打印到Windows打印机，主要用于发送原始文本和控制代码到POS打印机。该插件主要针对Windows平台。

开始使用

Directprint() 类允许您借助"print"方法直接向Windows打印机发送代码。

方法签名

Future<String?> print(String printer, String job, Uint8List data)

参数说明

• String printer: 系统打印机名称
• String job: 打印队列中的作业名称
• Uint8List data: 原始数据字节

返回值

• "OK": 如果调用没有错误结束
• "ERROR:1": 打开打印机时出错
• "ERROR:2": 打开文档时出错
• "ERROR:3": 启动页面时出错
• "ERROR:4": 打印计数时出错

安装

1. 将此包添加到您的pubspec.yaml文件中，如安装选项卡所述。
2. 导入库：

import 'package:directprint/directprint.dart';

示例代码

下面是一个完整的示例，展示了如何使用directprint插件进行打印操作：

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:directprint/directprint.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final _directprintPlugin = Directprint();
  String _printStatus = 'Unknown';
  String _printerName = 'Unknown';
  String _jobName = 'Unknown';

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Center(
          child: Padding(
            padding: const EdgeInsets.all(20),
            child: Column(
              mainAxisSize: MainAxisSize.max,
              children: [
                ElevatedButton(
                    onPressed: () {
                      _directPrintText();
                    },
                    child: const Text('Direct Print Test')),
                const SizedBox(height: 10),
                ElevatedButton(
                    onPressed: () {
                      _directPrintTextWithError();
                    },
                    child: const Text('Direct Print Test with Error')),
                const SizedBox(height: 10),
                Text('Print status: $_printStatus'),
                const SizedBox(height: 10),
                Text('Printer: $_printerName'),
                Text('Job name: $_jobName'),
                Expanded(child: Container()),
                Container(
                  child: const Text('Check printer name ...'),
                )
              ],
            ),
          ),
        ),
      ),
    );
  }

  Future<void> _directPrintText() async {
    debugPrint('Direct print test ...');
    try {
      String data = "Direct print plugin test ...\n\n\n\n";
      Uint8List enctxt = Uint8List.fromList(data.codeUnits);
      String printer = 'POS-58';
      String job = 'Invoice';

      String dpResult =
          await _directprintPlugin.print(printer, job, enctxt) ?? '';

      setState(() {
        _printerName = printer;
        _jobName = job;
        _printStatus = dpResult;
      });

      debugPrint('dpResult=$dpResult');
      debugPrint('Test finished.');
    } catch (e) {
      debugPrint(e.toString());
    }
  }

  Future<void> _directPrintTextWithError() async {
    debugPrint('Direct print test ...');
    try {
      String data = "Direct print plugin test ...\n\n\n\n";
      Uint8List enctxt = Uint8List.fromList(data.codeUnits);
      String printer = 'unknown'; // 使用不存在的打印机名称来测试错误处理
      String job = 'Invoice';

      String dpResult =
          await _directprintPlugin.print(printer, job, enctxt) ?? '';

      setState(() {
        _printerName = printer;
        _jobName = job;
        _printStatus = dpResult;
      });

      debugPrint('dpResult=$dpResult');
      debugPrint('Test finished.');
    } catch (e) {
      debugPrint(e.toString());
    }
  }
}

这段代码创建了一个简单的Flutter应用，其中包含两个按钮：一个用于正常打印测试，另一个用于模拟打印错误的情况（通过指定一个不存在的打印机名称）。这有助于理解和调试在实际应用中可能遇到的问题。