패키지, 저장소 및 앱 카테고리 검색

패키지 상세v1.2.4

flutter_pos_printer_platform_image_3

Android, iOS, Windows 등 다양한 플랫폼과 블루투스 및 BLE, TCP 및 USB 등의 다양한 인터페이스에서 프린터에 ESC 명령을 전송하는 Flutter 플러그인

AndroidiOSWindows
30일 다운로드
2천
좋아요
58
Pub 점수
110

패키지 설치

flutter pub add flutter_pos_printer_platform_image_3

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

안드로이드, iOS 및 윈도우에서 블루투스, BLE, TCP 및 USB 인터페이스를 통해 다양한 프린터에 ESC/POS 명령을 사용하여 크로스 플랫폼 인쇄를 가능하게 하는 플러터 플러그인입니다. 소매, 환대 및 판매점 시스템의 영수증 프린터에 적합한 원시 프린터 명령을 전송하기 위한 통합 API를 제공합니다. 플러그인은 플랫폼별 구현을 추상화하여 다양한 장치와 운영 체제 간의 통합을 단순화합니다.

사용 사례

  • POS 시스템에서 영수증 인쇄
  • 블루투스 또는 USB를 통한 모바일 인쇄
  • 크로스 플랫폼 인쇄 애플리케이션
  • 소매 및 레스토랑 주문 처리
  • TCP/IP를 통한 원격 인쇄

주요 기능

  • 다양한 플랫폼(안드로이드, 아이오스, 윈도우)을 지원합니다
  • ESC/POS 명령 전송 처리
  • 블루투스, BLE, TCP 및 USB와 호환
  • 플랫폼 간 통합 API
  • 가볍고 효율적

적합한 대상

  • POS 앱을 개발하는 개발자
  • 다기기 인쇄가 필요한 기업
  • 신뢰할 수 있는 영수증 인쇄가 필요한 응용 프로그램
  • 크로스 플랫폼 모바일 솔루션
  • ESC/POS 프린터와 함께 작업하는 하드웨어 통합 엔지니어

고려 사항

  • 호환되는 ESC/POS 프린터가 필요합니다
  • 플랫폼별 설정이 필요할 수 있습니다
  • ESC/POS 명령 세트로 제한
  • 블루투스 페어링은 수동으로 처리해야 합니다
  • 내장된 인쇄 미리보기 또는 서식 도구 없음

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

flutter_pos_printer_platform

Pub Version

Notice: This library was initially forked from arthas1888 in order to use it in a flutter project that use both image v4 and image v3 dart libraries. And since then, the library received many bug fixes after the original library was discontinued.


A library to discover printers, and send printer commands.

This library allows to print esc commands to printers in different platforms such as android, ios, windows and different interfaces as Bluetooth and BLE, USB and Wifi/Ethernet

Inspired by flutter_pos_printer.

Main Features

  • Android, iOS and Windows support
  • Scan for bluetooth devices
  • Send raw List<int> bytes data to a device, review this library to generate ESC/POS commands flutter_esc_pos_utils.

Features

Android iOS Windows Description
USB interface :white_check_mark: :white_square_button: :white_check_mark: Allows connection with usb devices.
Bluetooth classic interface :white_check_mark: :white_square_button: :white_square_button: Allows connection with classic bt devices.
Bluetooth low energy (BLE) interface :white_check_mark: :white_check_mark: :white_square_button: Allows connection with bt BLE devices.
Net (ethernet/wifi) interface :white_check_mark: :white_check_mark: :white_check_mark: Allows connection with network devices.
scan :white_check_mark: :white_check_mark: :white_check_mark: Starts a scan for only Bluetooth devices or network devices(Android/iOS).
connect :white_check_mark: :white_check_mark: :white_check_mark: Establishes a connection to the device.
disconnect :white_check_mark: :white_check_mark: :white_check_mark: Cancels an active or pending connection to the device.
state :white_check_mark: :white_check_mark: :white_check_mark: Stream of state changes for the Bluetooth Device.
print :white_check_mark: :white_check_mark: :white_check_mark: print bytes.

Getting Started

For a full example please check /example folder. Here are only the most important parts of the code to illustrate how to use the library.

Generate bytes to print through flutter_esc_pos_utils.

    import 'package:esc_pos_utils/esc_pos_utils.dart';

    final profile = await CapabilityProfile.load();
    final generator = Generator(PaperSize.mm58, profile);
    List<int> bytes = [];

    bytes += generator.text('Test Print', styles: const PosStyles(align: PosAlign.center));
    bytes += generator.text('Product 1');
    bytes += generator.text('Product 2');

Android

Allow to connect bluetooth (classic and BLE), USB and network devices

Change the minSdkVersion for Android

flutter_pos_printer_platform is compatible only from version 21 of Android SDK so you should change this in android/app/build.gradle:

In build.gradle set

    defaultConfig {
        ...
        minSdkVersion 21
        targetSdkVersion 31
        ...

select type of device PrinterType ( bluetooth, usb, network)

if select bluetooth you can send optional params

  • isBle -> allow to connect with bluetooth that supports this technology
  • autoconnect -> allow to reconnect when state of device is None

iOS

Allow to connect bluetooth (BLE) and network devices

Windows

Allow to connect USB and network devices To network devices is necessary to set ipAddress

How to use it

init a PrinterManager instance
import 'package:flutter_pos_printer_platform/flutter_pos_printer_platform.dart';

    var printerManager = PrinterManager.instance;

scan
    var devices = [];
    _scan(PrinterType type, {bool isBle = false}) {
        // Find printers
        PrinterManager.instance.discovery(type: type, isBle: isBle).listen((device) {
            devices.add(device);
        });
    }
connect
_connectDevice(PrinterDevice selectedPrinter, PrinterType type, {bool reconnect = false, bool isBle = false, String? ipAddress = null}) async {
    switch (type) {
      // only windows and android
      case PrinterType.usb:
        await PrinterManager.instance.connect(
            type: type,
            model: UsbPrinterInput(name: selectedPrinter.name, productId: selectedPrinter.productId, vendorId: selectedPrinter.vendorId));
        break;
      // only iOS and android
      case PrinterType.bluetooth:
        await PrinterManager.instance.connect(
            type: type,
            model: BluetoothPrinterInput(
                name: selectedPrinter.name,
                address: selectedPrinter.address!,
                isBle: isBle,
                autoConnect: reconnect));
        break;
      case PrinterType.network:
        await PrinterManager.instance.connect(type: type, model: TcpPrinterInput(ipAddress: ipAddress ?? selectedPrinter.address!));
        break;
      default:
    }
  }
disconnect
    _disconnectDevice(PrinterType type) async {
        await PrinterManager.instance.disconnect(type: type);
        }
listen bluetooth state
    PrinterManager.instance.stateBluetooth.listen((status) {
      log(' ----------------- status bt $status ------------------ ');
    });
send bytes to print
    _sendBytesToPrint(List<int> bytes, PrinterType type) async { 
      PrinterManager.instance.send(type: type, bytes: bytes);
    }

Troubleshooting

error:'State restoration of CBCentralManager is only allowed for applications that have specified the "bluetooth-central" background mode' info.plist add:

<key>NSBluetoothAlwaysUsageDescription</key>
<string>Allow App use bluetooth?</string>
<key>NSBluetoothPeripheralUsageDescription</key>
<string>Allow App use bluetooth?</string>
<key>UIBackgroundModes</key>
<array>
    <string>bluetooth-central</string>
    <string>bluetooth-peripheral</string>
</array>

Credits

  • https://github.com/andrey-ushakov/esc_pos_utils
  • https://github.com/bailabs/esc-pos-printer-flutter
  • https://github.com/feedmepos/flutter_printer/tree/master/packages/flutter_pos_printer
  • https://pub.dev/packages/flutter_pos_printer_platform

Support Original Author

If you think that this project has helped you with your developments, you can support this project, any support is much appreciated.

Paypal

카테고리

의존성

의존성 목록 5 개

소스 저장소

이 패키지를 사용하는 프로젝트

아직 데이터가 없습니다.