搜尋套件、儲存庫與 APP 分類

套件詳情v5.0.0

zsdk

一個用於 Zebra Link OS 打印機的 Flutter 插件,可透過 TCP/IP 連接進行 ZPL 與 PDF 印表。

AndroidiOS
近 30 天下載
1160
喜歡數
43
Pub 分數
150

安裝套件

flutter pub add zsdk

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

zsdk 是一個 Flutter 插件,透過 Zebra Link OS 實現與 Zebra 印表機的通訊,支援透過 TCP/IP 進行 ZPL 與 PDF 印刷。它允許開發者直接從 Flutter 應用程式將列印工作傳送至相容的 Zebra 設備,促進移動列印工作流程中的無縫整合。此外,該插件專為 Android 與 iOS 平台設計,提供穩定的連線與高效能的列印能力。它利用 Zebra Link OS API 來管理印表機指令與狀態監控。

適用情境

  • 移動庫存管理
  • 條碼標籤列印
  • 發貨單生成
  • 零售收據打印
  • 資產標籤系統

主要特色

  • ZPL 和 PDF 列印支援
  • TCP/IP連接處理
  • 跨平台相容性(Android/iOS)
  • 印表機狀態監控
  • 用於列印作業提交的簡單 API

適合對象

  • 開發移動列印解決方案的開發者
  • 使用齊普拉打印機的企业
  • 物流和零售應用
  • 現場服務和倉儲應用

使用建議

  • 需要配備 Link OS 的斑馬列印機
  • TCP/IP所需的網路設定
  • 僅限配備 Link OS 的斑馬印表機型號
  • 可能需要額外設定才能建立安全連接
  • 不適用於非斑馬印表機

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

zsdk

Zebra Link OS SDK Flutter plugin.

This is a flutter plugin for the Link-OS Multiplatform SDK for Zebra

Features
Feature iOS (TCP/IP) iOS (Bluetooth) Android (TCP/IP) Android (Bluetooth)
Print ZPL from String :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Print ZPL from file :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Print PDF from byte array :x: :x: :x: :x:
Print PDF from file :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Get printer settings :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Set printer settings :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Check printer status :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Print configuration label :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Run calibration :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Reboot printer :white_check_mark: :white_check_mark: :white_check_mark: :white_check_mark:
Connection Types
  • TCP/IP: Supported on both iOS and Android
  • Bluetooth: Supported on both iOS and Android (requires additional setup)
Note:

Since v3.1.0+1 the plugin supports PDF direct printing on both iOS and Android, before this version, the PDF printing was only available on Android, and it was by using some kind of workaround converting the PDF to image and printing it as image, which was not reliable and caused some issues depending on the document dimensions, etc. Now the PDF Direct printing is the right way and according to the manufacturer, you just need to be sure your printing OS is >= Link-OS v6.3 and you have installed the Virtual Device for PDF Direct.

Steps:

  1. Upgrade Zebra Printer Firmware
  2. Install and Enable Virtual Device for PDF Direct

iOS Setup
Podfile
target 'Runner' do
  use_frameworks!
  use_modular_headers!

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
end
Bluetooth Support (iOS)

If you want to use Bluetooth connectivity on iOS, you need to configure your app for MFi (Made for iPhone) accessories and configure the required permissions:

  1. Add the following keys to your Info.plist:
<key>UISupportedExternalAccessoryProtocols</key>
<array>
    <string>com.zebra.rawport</string>
</array>

<!-- Required for Bluetooth permission requests on iOS 13+ -->
<key>NSBluetoothAlwaysUsageDescription</key>
<string>This app uses Bluetooth to connect to Zebra printers</string>

<key>NSBluetoothCentralUsageDescription</key>
<string>This app needs Bluetooth access to discover and connect to Zebra printers</string>

<key>NSBluetoothPeripheralUsageDescription</key>
<string>This app uses Bluetooth to communicate with Zebra printers in the background</string>
  1. If using permission_handlerplugin, update your Podfile to enable Bluetooth permissions. Ensure the following line is present in the post_install block:
    'PERMISSION_BLUETOOTH=1',
  1. Add the ExternalAccessory framework to your Xcode project (usually automatic via CocoaPods).

  2. Request Bluetooth permissions at runtime before using any Bluetooth features:

import 'package:permission_handler/permission_handler.dart';

Future<bool> requestBluetoothPermissions() async {
  final btConnect = await Permission.bluetoothConnect.request();
  final btScan = await Permission.bluetoothScan.request();
  
  if (btConnect.isPermanentlyDenied || btScan.isPermanentlyDenied) {
    // Permissions are permanently denied, open app settings
    openAppSettings();
    return false;
  }
  
  return btConnect.isGranted && btScan.isGranted;
}

Important Notes:

  • iOS uses MFi (Made for iPhone) Bluetooth, which requires the ExternalAccessory framework
  • On iOS, Bluetooth uses the printer's serial number instead of MAC address
  • Use getBondedDevices() to discover connected Zebra printers - the address field contains the serial number
  • If permissions show as permanentlyDenied, the user must enable them in Settings > [App Name] > Bluetooth
  • Always test permissions on a real iOS device; simulators don't support Bluetooth
Android Setup
TCP/IP Only

No setup required.

Bluetooth Support

If you want to use Bluetooth connectivity, you need to add the following permissions to your app's AndroidManifest.xml:

<!-- Bluetooth permissions for Android 11 and below -->
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />

<!-- Bluetooth permissions for Android 12+ -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

<!-- Optional: Only needed if you want to discover/scan for printers -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

Note: You also need to request these permissions at runtime before using Bluetooth features. Consider using a package like permission_handler to handle runtime permission requests.

Bluetooth Device Identifier

The Bluetooth methods use the macAddress parameter:

  • Android: Use the printer's MAC address (e.g., "AC:3F:A4:12:34:56")
  • iOS: Use the printer's serial number (obtained from getBondedDevices())

How to use

Add dependency
# Add this line to your flutter project dependencies
zsdk: ^2.0.0+11

and run flutter pub get to download the library sources to your pub-cache.

Initialize a ZSDK object
final zsdk = ZSDK();
Start the printer calibration
zsdk.doManualCalibrationOverTCPIP(
  address: '10.0.0.100', 
  port: 9100 //optional
)
Get printer settings
zsdk.getPrinterSettingsOverTCPIP(
  address: '10.0.0.100', 
  port: 9100 //optional
).then(value) {
 final printerSettings = PrinterResponse.fromMap(value).settings;
};
Set printer settings
zsdk.setPrinterSettingsOverTCPIP(
  address: '10.0.0.100', 
  port: 9100, //optional
  settings: PrinterSettings(
    darkness: 10,
    printSpeed: 6,
    tearOff: 0,
    mediaType: MediaType.MARK,
    printMethod: PrintMethod.DIRECT_THERMAL,
    printWidth: 568,
    labelLength: 1202,
    labelLengthMax: 39,
    zplMode: ZPLMode.ZPL_II,
    powerUpAction: PowerUpAction.NO_MOTION,
    headCloseAction: HeadCloseAction.NO_MOTION,
    labelTop: 0,
    leftPosition: 0,
    printMode: PrintMode.TEAR_OFF,
    reprintMode: ReprintMode.OFF,
  )
).then(value) {
  final printerResponse = PrinterResponse.fromMap(value);
  if(printerResponse.errorCode == ErrorCode.SUCCESS) {
    //Do something
  } else {
    Status status = printerResponse.statusInfo.status;
    Cause cause = printerResponse.statusInfo.cause;
    //Do something
  }
}
Reset printer settings
zsdk.setPrinterSettingsOverTCPIP(
  address: '10.0.0.100', 
  port: 9100, //optional
  settings: PrinterSettings.defaultSettings()
).then(value) {
   final printerResponse = PrinterResponse.fromMap(value);
   if(printerResponse.errorCode == ErrorCode.SUCCESS) {
     //Do something
   } else {
     Status status = printerResponse.statusInfo.status;
     Cause cause = printerResponse.statusInfo.cause;
     //Do something
   }
 }
Check printer status
zsdk.checkPrinterStatusOverTCPIP(
  address: '10.0.0.100', 
  port: 9100, //optional
).then(value) {
   final printerResponse = PrinterResponse.fromMap(value);
   Status status = printerResponse.statusInfo.status;
   print(status);
   if(printerResponse.errorCode == ErrorCode.SUCCESS) {
     //Do something 
   } else {
     Cause cause = printerResponse.statusInfo.cause;
     print(cause);
   }
 }
Reboot printer
zsdk.rebootPrinter(
  address: '10.0.0.100', 
  port: 9100, //optional
).then(value) {
   final printerResponse = PrinterResponse.fromMap(value);
   Status status = printerResponse.statusInfo.status;
   print(status);
   if(printerResponse.errorCode == ErrorCode.SUCCESS) {
     //Do something 
   } else {
     Cause cause = printerResponse.statusInfo.cause;
     print(cause);
   }
 }
Print zpl file
zsdk.printZplFileOverTCPIP(
  filePath: '/path/to/file.pdf',
  address: '10.0.0.100', 
  port: 9100, //optional
).then(value) {
   final printerResponse = PrinterResponse.fromMap(value);
   Status status = printerResponse.statusInfo.status;
   print(status);
   if(printerResponse.errorCode == ErrorCode.SUCCESS) {
     //Do something 
   } else {
     Cause cause = printerResponse.statusInfo.cause;
     print(cause);
   }
 }
Print zpl data
zsdk.printZplDataOverTCPIP(
  data: '^XA^FO17,16^GB379,371,8^FS^FT65,255^A0N,135,134^FDTEST^FS^XZ',
  address: '10.0.0.100', 
  port: 9100, //optional
).then(value) {
   final printerResponse = PrinterResponse.fromMap(value);
   Status status = printerResponse.statusInfo.status;
   print(status);
   if(printerResponse.errorCode == ErrorCode.SUCCESS) {
     //Do something 
   } else {
     Cause cause = printerResponse.statusInfo.cause;
     print(cause);
   }
 }
Print pdf file
zsdk.printPdfFileOverTCPIP(
  filePath: '/path/to/file.pdf',
  address: '10.0.0.100', 
  port: 9100, //optional
).then(value) {
   final printerResponse = PrinterResponse.fromMap(value);
   Status status = printerResponse.statusInfo.status;
   print(status);
   if(printerResponse.errorCode == ErrorCode.SUCCESS) {
     //Do something 
   } else {
     Cause cause = printerResponse.statusInfo.cause;
     print(cause);
   }
 }

Bluetooth Examples (Android only)

All Bluetooth methods mirror their TCP/IP counterparts, but use macAddress instead of address and port.

Example: Print ZPL over Bluetooth
zsdk.printZplDataOverBluetooth(
  data: '^XA^FO17,16^GB379,371,8^FS^FT65,255^A0N,135,134^FDTEST^FS^XZ',
  macAddress: 'AC:3F:A4:12:34:56',
).then(value) {
   final printerResponse = PrinterResponse.fromMap(value);
   if(printerResponse.errorCode == ErrorCode.SUCCESS) {
     //Do something
   } else {
     Cause cause = printerResponse.statusInfo.cause;
     print(cause);
   }
 }

All Bluetooth methods mirror their TCP/IP counterparts (e.g., printZplFileOverBluetooth, checkPrinterStatusOverBluetooth, etc.).

Tested Zebra Devices
  • Zebra ZT411
  • Zebra ZD500 Series
  • ZD620
  • ZQ620

所屬分類

原始碼儲存庫

使用此套件的專案

暫無相關資料。