network_printer_plugin #

Plugin Flutter untuk mencetak ke printer jaringan (network printer) seperti thermal printer via TCP/IP.

Fitur #

• 🖨️ Koneksi ke printer jaringan via TCP/IP
• 📝 Mengirim data ESC/POS ke printer
• 🔌 Manajemen koneksi (connect, write, disconnect)
• ⚡ Simple dan mudah digunakan

Instalasi #

Tambahkan dependensi ke file pubspec.yaml:

dependencies:
  network_printer_plugin: ^0.0.1
  esc_pos_utils: ^1.1.0  # Untuk generate ESC/POS commands

Kemudian jalankan:

flutter pub get

Penggunaan #

Import Package #

import 'package:network_printer_plugin/network_printer_plugin.dart';
import 'package:esc_pos_utils/esc_pos_utils.dart';

Contoh Dasar #

// 1. Buat instance NetworkPrinter
var printer = NetworkPrinter();

// 2. Koneksi ke printer (gunakan IP address dan port printer Anda)
await printer.connect("192.168.0.101", 9100);

// 3. Kirim data ke printer
await printer.write(bytes);

// 4. Tutup koneksi
await printer.disconnect();

Contoh Lengkap #

Berikut contoh lengkap untuk mencetak berbagai format text dan barcode:

import 'package:esc_pos_utils/esc_pos_utils.dart';
import 'package:flutter/material.dart';
import 'package:network_printer_plugin/network_printer_plugin.dart';

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

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Network Printer Example'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              // Load capability profile untuk printer
              final profile = await CapabilityProfile.load();
              
              // Buat generator untuk paper size 80mm
              var generator = Generator(PaperSize.mm80, profile);
              List<int> bytes = [];

              // Print text biasa
              bytes += generator.text('Regular text: Hello World!');
              
              // Print text dengan karakter spesial
              bytes += generator.text('Special chars: àÀ èÈ éÉ ûÛ',
                  styles: PosStyles(codeTable: 'CP1252'));

              // Print text dengan style
              bytes += generator.text('Bold text', 
                  styles: PosStyles(bold: true));
              bytes += generator.text('Reverse text', 
                  styles: PosStyles(reverse: true));
              bytes += generator.text('Underlined text',
                  styles: PosStyles(underline: true), linesAfter: 1);

              // Print text dengan alignment
              bytes += generator.text('Align left', 
                  styles: PosStyles(align: PosAlign.left));
              bytes += generator.text('Align center', 
                  styles: PosStyles(align: PosAlign.center));
              bytes += generator.text('Align right',
                  styles: PosStyles(align: PosAlign.right), linesAfter: 1);

              // Print dalam kolom
              bytes += generator.row([
                PosColumn(
                  text: 'Item',
                  width: 6,
                  styles: PosStyles(align: PosAlign.left),
                ),
                PosColumn(
                  text: 'Qty',
                  width: 3,
                  styles: PosStyles(align: PosAlign.center),
                ),
                PosColumn(
                  text: 'Price',
                  width: 3,
                  styles: PosStyles(align: PosAlign.right),
                ),
              ]);

              // Print text dengan ukuran besar
              bytes += generator.text('LARGE TEXT',
                  styles: PosStyles(
                    height: PosTextSize.size2,
                    width: PosTextSize.size2,
                  ));

              // Print barcode
              final List<int> barData = [1, 2, 3, 4, 5, 6, 7, 8, 9, 0, 4];
              bytes += generator.barcode(Barcode.upcA(barData));

              // Feed paper dan cut
              bytes += generator.feed(2);
              bytes += generator.cut();

              // Kirim ke printer
              var printer = NetworkPrinter();
              try {
                await printer.connect("192.168.0.101", 9100);
                await printer.write(bytes);
                await printer.disconnect();
                print('Print berhasil!');
              } catch (e) {
                print('Print gagal: $e');
              }
            },
            child: const Text('Test Print'),
          ),
        ),
      ),
    );
  }
}

API Reference #

NetworkPrinter Class #

Methods

connect(String host, int port)

Membuat koneksi ke printer jaringan.

Parameters:

• host (String): IP address printer (contoh: "192.168.0.101")
• port (int): Port printer (umumnya 9100 untuk thermal printer)

Returns: Future<void>

Throws: Exception jika koneksi gagal

Example:

await printer.connect("192.168.0.101", 9100);

write(List<int> data)

Mengirim data byte ke printer.

Parameters:

• data (List

Returns: Future<void>

Throws: Exception jika pengiriman data gagal

Example:

await printer.write(bytes);

disconnect()

Menutup koneksi ke printer.

Returns: Future<void>

Throws: Exception jika pemutusan koneksi gagal

Example:

await printer.disconnect();

Tips & Troubleshooting #

Menemukan IP Address Printer #

1. Print configuration page dari printer Anda
2. Atau gunakan network scanner tools
3. Pastikan perangkat Anda dan printer dalam satu jaringan

Port yang Umum Digunakan #

• 9100: Port standar untuk RAW printing (paling umum)
• 9101, 9102: Port alternatif pada beberapa printer

Error Handling #

Selalu gunakan try-catch untuk menangani error:

try {
  var printer = NetworkPrinter();
  await printer.connect("192.168.0.101", 9100);
  await printer.write(bytes);
  await printer.disconnect();
} catch (e) {
  print('Error: $e');
  // Handle error sesuai kebutuhan
}

Timeout Connection #

Koneksi memiliki timeout 5 detik. Jika printer tidak merespons dalam waktu tersebut, koneksi akan gagal.

Kompatibilitas #

Plugin ini mendukung printer yang support ESC/POS commands, termasuk:

• Thermal receipt printers
• POS printers
• Network-enabled printers dengan protokol TCP/IP

Lisensi #

Lihat file LICENSE untuk informasi lebih lanjut.

Kontribusi #

Kontribusi sangat diterima! Silakan buat issue atau pull request di repository ini.