zebra_printer 0.4.1

Flutter management package for Zebra printers. Uses Zebra Link-OS SDK for Bluetooth & Network discovery, ZPL printing, and printer management.

Zebra Printer 🦓

Flutter package for Zebra Link-OS™ Printers. Uses the official Zebra SDK for discovery, status monitoring, ZPL printing, and printer management.

Platform: Android only (API 21+)

---

Features

• Bluetooth & Network discovery via Zebra SDK
• Safe single & batch printing with lock & progress tracking
• Full printer status (ZebraPrinterStatus) and device info (PrinterInfo)
• Font upload to printer flash (uploadFont, uploadFontData)
• Generic Bluetooth pairing via BluetoothManager

---

Installation

dependencies:
  zebra_printer: ^0.4.1

Add to AndroidManifest.xml:

<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.INTERNET" />

---

API Overview

PrinterManager — Zebra SDK

Method	Description
startDiscovery(type)	Find printers (bluetooth / network / both)
stopDiscovery()	Stop active discovery
connect(address)	Open persistent connection
disconnect({address})	Close connection
isConnected({address})	Check connection state
safePrint(address, zpl)	Print with lock & progress
safeBatchPrint(address, zplList)	Batch print in one session
getZebraPrinterStatus(address)	Full status (isReadyToPrint, paper out, etc.)
getPrinterInfo(address)	Model, serial, firmware
canPrint(address)	Quick readiness check
isPrinterBusy(address)	Check if printer is busy
waitForPrinterReady(address)	Poll until ready or timeout
calibratePrinter(address, type)	Gap/bar calibration
printTestLabel(address)	Send built-in test label
uploadFont(address, assetPath)	Upload font from assets
uploadFontData(address, bytes)	Upload font from raw bytes
getPairedPrinters()	List paired Bluetooth devices
unpairPrinter(address)	Remove device pairing
dispose() / reinitialize()	Lifecycle management

Callbacks: onPrinterFound, onDiscoveryFinished, onConnectionStateChanged, onPrintProgress

BluetoothManager — Android Bluetooth API

Method	Description
startDiscovery() / stopDiscovery()	Scan for devices
getBondedDevices()	List paired devices
pairDevice(address) / unpairDevice(address)	Pairing management
connect(address) / disconnect()	Generic BT connection
isBluetoothEnabled()	Check BT state
dispose() / reinitialize()	Lifecycle management

Streams: onDeviceFound, onDiscoveryFinished, onConnectionStateChanged, onScanStateChanged

---

Quick Start

import 'package:zebra_printer/zebra_printer.dart';

final printer = PrinterManager();

// Callbacks
printer.onPrinterFound = (p) => print('Found: ${p.name}');
printer.onPrintProgress = (p) => print('${p.percentage}% — ${p.message}');

// Discover & print
await printer.startDiscovery(type: DiscoveryType.bluetooth);
await printer.safePrint('AC:3F:A4:XX:XX:XX', '^XA^FO50,50^FDTest^FS^XZ');

// Status & info
final status = await printer.getZebraPrinterStatus('AC:3F:A4:XX:XX:XX');
final info = await printer.getPrinterInfo('AC:3F:A4:XX:XX:XX');

// Font upload (0.4.0+)
await printer.uploadFont('AC:3F:A4:XX:XX:XX', 'assets/fonts/arial.zpl');

// Cleanup
printer.dispose();

Full UI example with progress tracking: example/

---

Troubleshooting

Issue	Solution
Printer not found	Enable Bluetooth & Location, grant permissions
Connection failed	Printer may be connected to another device
Misaligned labels	calibratePrinter(address, CalibrationType.gap)
ZPL preview	Labelary Viewer — wrap with ^XA / ^XZ

---

License

MIT — Copyright (c) 2025 Samed Demir · Powered by Zebra Link-OS™ SDK