Flutter打印机控制插件rongta_printer的使用

Flutter打印机控制插件rongta_printer的使用

A Flutter插件用于使用Rongta热敏打印机打印。 🖨️

特性

• 打印任何内容 🤯: 可以打印任何形状的控件，绕过了Rongta原生SDK的限制。
• 了解打印机状态 💡: 接收关于打印机连接和文档传输的状态更新。

安装

在pubspec.yaml文件中添加以下依赖：

plugin_name: ^1.0.0

设置

该代码默认适用于Android，并且iOS需要进行一个步骤的设置。

iOS设置

要使插件在iOS上运行，您需要添加蓝牙框架，请按以下步骤操作：

1. 在左侧导航栏中点击runner。
2. 从目标列表中选择目标。
3. 点击构建阶段。
4. 通过点击加号按钮添加一个新的“与二进制文件链接”。
5. 在搜索框中输入“Bluetooth”，并选择CoreBluetooth.framework。

使用

在Dart文件中导入插件：

import 'package:rongta_printer/rongta_printer.dart';

示例

初始化与打印机的连接：

...
final _rongtaPrinterPlugin = RongtaPrinter();

void onConnectionStatusChanged(PrinterConnectionStatus status) {...}
void onOperationStatusChanged(PrinterOperationStatus status) {...}
...
await _rongtaPrinterPlugin.init(
  macAddress: 'DC:0D:30:95:39:A2',
  onPrinterConnectionChange: onConnectionStatusChanged,
  onDocPrinted: onOperationStatusChanged,
);
...

打印您的文档：

...
_rongtaPrinterPlugin.print(
  doc: Column(
    children: const [
      FlutterLogo(),
      Text('Rongta printing example'),
    ],
  ),
);
...

已知问题 ❗️

• 使用Image.memory不会显示任何内容，因为代码会立即加载图像，而从内存中加载则需要时间。

许可证

该项目根据Apache License 2.0许可发布 - 详情请参阅LICENSE文件。

贡献

欢迎贡献！请随时提交拉取请求。

致谢

代码基于Rongta的Android和iOS SDK构建，可以在这里找到。 🙌

示例代码

import 'dart:developer';

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

import 'package:flutter/services.dart';
import 'package:rongta_printer/core/enums.dart';
import 'package:rongta_printer/rongta_printer.dart';

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

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  PrinterConnectionStatus connectionStatus = PrinterConnectionStatus.initial;
  PrinterOperationStatus operationStatus = PrinterOperationStatus.idle;

  final _rongtaPrinterPlugin = RongtaPrinter();

  [@override](/user/override)
  void initState() {
    super.initState();
    initRongtaPlugin();
  }

  void onConnectionStatusChanged(PrinterConnectionStatus status) {
    log(connectionStatus.name, name: 'onConnectionStatusChanged');

    setState(() {
      connectionStatus = status;
    });
  }

  void onOperationStatusChanged(PrinterOperationStatus status) {
    log(operationStatus.name, name: 'onOperationStatusChanged');

    setState(() {
      operationStatus = status;
    });
  }

  // 平台消息异步发送，因此我们在异步方法中初始化。
  Future<void> initRongtaPlugin() async {
    try {
      WidgetsBinding.instance.addPostFrameCallback((timeStamp) {
        connectionStatus = PrinterConnectionStatus.loading;

        log(connectionStatus.name, name: 'initRongtaPlugin');

        setState(() {});
      });

      await _rongtaPrinterPlugin.init(
        macAddress: 'DC:0D:30:95:39:A2',
        onPrinterConnectionChange: onConnectionStatusChanged,
        onDocPrinted: onOperationStatusChanged,
      );
    } on PlatformException {
      log(
        '无法初始化Rongta打印机插件',
        name: 'initRongtaPlugin',
      );
    }

    // 如果小部件在异步平台消息发送时从树中移除，则我们希望丢弃回复而不是调用setState来更新不存在的外观。
    if (!mounted) return;
  }

  Widget? connectionStatusWidget() {
    switch (connectionStatus) {
      case PrinterConnectionStatus.initial:
        return null;
      case PrinterConnectionStatus.loading:
        return const CircularProgressIndicator();
      case PrinterConnectionStatus.connected:
        return const Icon(
          Icons.check_circle,
          color: Colors.green,
        );
      case PrinterConnectionStatus.disconnected:
        return const Icon(
          Icons.error,
          color: Colors.red,
        );
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Rongta打印机示例'),
        ),
        body: Column(
          children: [
            ListTile(
              title: const Text('打印机连接状态'),
              subtitle: Text(connectionStatus.name),
              trailing: connectionStatusWidget(),
            ),
            ListTile(
              title: const Text('打印机操作状态'),
              subtitle: Text(operationStatus.name),
            ),
            ElevatedButton(
              onPressed: connectionStatus == PrinterConnectionStatus.connected
                  ? () {
                      _rongtaPrinterPlugin.print(
                        context,
                        doc: const Column(
                          children: [
                            FlutterLogo(),
                            Text('Rongta打印示例'),
                          ],
                        ),
                      );
                    }
                  : null,
              child: const Text('打印测试文档'),
            ),
          ],
        ),
      ),
    );
  }
}