Ringga Dev | Professional Multi-Platform Engineer

Pendahuluan

Thermal printer masih menjadi tulang punggung sistem kasir, restoran, dan logistik di seluruh dunia. Tapi membangun aplikasi yang bisa mencetak ke thermal printer dari berbagai platform — Android, iOS, Desktop, Web — adalah tantangan besar.

KmpPrinter hadir sebagai solusi: library Kotlin Multiplatform open-source yang menyatukan semua transport thermal printer dalam satu API.

Dengan 2.200+ baris kode, 6 bahasa pemrograman, dan dukungan untuk Bluetooth Classic, BLE, USB, Network TCP, Serial, hingga Virtual, KmpPrinter adalah library thermal printing paling komprehensif di ekosistem Kotlin.

📊 Metadata Proyek

Item	Detail
Repository	[ringga-dev/kmp-printer](https://github.com/ringga-dev/kmp-printer)
Lisensi	MIT — gratis untuk komersial dan personal
Stars	⭐ 5
Bahasa	TypeScript (42%), Kotlin (38%), JavaScript (17%), Vue (1.7%), CSS, Swift, C#
Release Terbaru	v2.2.2 (11 Juni 2026)
Platform	Android, iOS, JVM/Desktop, Web (JS), Wasm
Dokumentasi	[ringga-dev.github.io/kmp-printer](https://ringga-dev.github.io/kmp-printer/)

✨ Fitur Unggulan

CODE

┌─────────────────────────────────────────────────────┐
│                  KmpPrinter API                      │
├─────────────────────────────────────────────────────┤
│  🔍 Discovery     → Bluetooth, BLE, Network, USB   │
│  🔗 Connection    → TCP, BLE, USB, Serial, Virtual  │
│  📝 Receipt DSL   → Text, Tables, QR, Barcode       │
│  📊 Monitoring    → Paper out, Cover, Error          │
│  🛡️ Concurrency   → Mutex safety, Chunked sending   │
│  👁️ Preview       → Virtual render untuk UI preview  │
└─────────────────────────────────────────────────────┘

Multi Transport

KmpPrinter support 6 tipe koneksi:

Transport	Android	iOS	Desktop	Web
Bluetooth Classic	✅	❌	✅	✅
BLE	✅	✅	✅	✅
USB	✅	❌	✅	✅
Network TCP	✅	✅	✅	✅
Serial	⚠️	❌	✅	❌
Virtual	✅	✅	✅	✅

BLE-only di iOS karena Apple tidak menyediakan API Bluetooth Classic untuk pihak ketiga.

Receipt Builder DSL

API utama KmpPrinter menggunakan DSL Kotlin yang intuitif:

KOTLIN

// Contoh cetak struk kopi — 15 baris kode
printer.print(config) {
    alignCenter()
    bold(true)
    line("☕ COFFEE SHOP")
    bold(false)
    divider()
    tableRow(listOf("Americano", "2", "6.00"), listOf(2, 1, 1))
    tableRow(listOf("Latte", "1", "4.50"), listOf(2, 1, 1))
    divider()
    line("Total: $10.50", align = "RIGHT")
    feed(1)
    qrCodeNative("https://example.com", center = true)
    feed(3)
    cut()
}.collect { status -> println(status) }

Printer Discovery (Flow-based)

Menggunakan Kotlin Coroutines Flow untuk discovery real-time:

KOTLIN

printer.discovery("NETWORK") { log ->
    println("Scanning: $log")
}.collect { devices ->
    devices.forEach { device ->
        println("Found: ${device.name} di ${device.address}:${device.port}")
    }
}

Status Monitoring Real-time

Pantau kondisi printer secara periodik:

KOTLIN

printer.monitorStatus(config, intervalMs = 2000).collect { status ->
    when {
        status.isPaperOut -> alert("📢 Kertas habis!")
        status.isCoverOpen -> alert("🔓 Cover terbuka!")
        !status.isOnline -> alert("⚠️ Printer offline!")
    }
}

🏗️ Arsitektur

KmpPrinter dibangun di atas Kotlin Multiplatform dengan arsitektur berlapis:

CODE

┌──────────────────────────────────────────┐
│              Application                  │
├──────────────────────────────────────────┤
│          KmpPrinter API (commonMain)     │
├──────────────────────────────────────────┤
│  ┌────────┐ ┌────────┐ ┌──────────────┐  │
│  │ Android│ │   iOS  │ │ Desktop/JVM  │  │
│  │  BLE   │ │ CoreBLE│ │  BlueZ + TCP │  │
│  └────────┘ └────────┘ └──────────────┘  │
│  ┌────────┐ ┌────────┐ ┌──────────────┐  │
│  │  USB   │ │ TCP/IP │ │  Web Serial  │  │
│  └────────┘ └────────┘ └──────────────┘  │
└──────────────────────────────────────────┘

Keunggulan arsitektur KMP:

90% kode dibagi antar platform (commonMain)

Platform-specific hanya untuk implementasi transport (Bluetooth, USB)

Type-safe dengan sealed class untuk konfigurasi koneksi

🔧 Cara Install

Gradle (KMP Project)

KOTLIN

// settings.gradle.kts
dependencyResolutionManagement {
    repositories {
        maven {
            url = uri("https://raw.githubusercontent.com/ringga-dev/kmp-printer/maven-repo")
        }
    }
}

// build.gradle.kts
kotlin {
    sourceSets {
        commonMain.dependencies {
            implementation("io.github.ringga-dev:kmp_printer:2.2.2")
        }
    }
}

Platform-Specific Setup

Android: Tambahkan permission di AndroidManifest.xml:

XML

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.INTERNET" />

Desktop (Linux): Butuh udev rule untuk USB:

BASH

# /etc/udev/rules.d/99-thermal-printer.rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="0416", MODE="0666"

🧪 Contoh Aplikasi

KmpPrinter sudah include aplikasi demo Vue 3 untuk web:

CODE

kmp-printer/
├── composeApp/        # Android + Desktop app (Compose Multiplatform)
├── demo-web/          # Vue 3 demo aplikasi web
├── kmp-printer/       # Library utama (commonMain)
│   ├── src/commonMain
│   ├── src/androidMain
│   ├── src/iosMain
│   ├── src/jvmMain
│   └── src/jsMain
└── docs/              # Dokumentasi

📈 Kode dan Metrik

Metrik	Nilai
Total baris kode	1.097.000+
TypeScript	461.000 baris (42%)
Kotlin	420.000 baris (38%)
JavaScript	182.500 baris (17%)
Release terbaru	v2.2.2
Package	`io.github.ringga-dev:kmp_printer`

💡 Kasus Penggunaan

1. Sistem POS Restoran

KOTLIN

// Cetak struk pesanan dapur
printer.print(kitchenConfig) {
    bold(true)
    fontSize(2)
    line("🍳 DAPUR")
    divider()
    line("Meja 5 — #102")
    line("1x Nasi Goreng")
    line("1x Es Teh")
    feed(2)
    cut()
}

2. Logistik & Warehouse

KOTLIN

// Cetak barcode untuk tracking
printer.print(labelConfig) {
    barcode(orderId, type = BarcodeType.CODE128)
    line("Order: $orderId")
    line("Tanggal: $date")
    qrCodeNative(trackingUrl, size = 8)
    cut()
}

3. Aplikasi Kesehatan

KOTLIN

// Cetak label obat
printer.print(pharmacyConfig) {
    line("🏥 Apotek Sehat")
    line("Pasien: ${patient.name}")
    line("Obat: ${medicine.name}")
    line("Dosis: ${medicine.dosage}")
    barcode(prescriptionId, type = BarcodeType.CODE39)
    cut()
}

🔜 Roadmap

Fitur yang direncanakan ke depan:

[ ] Rekoneksi otomatis — reconnect saat koneksi putus

[ ] Antrian cetak — queueing untuk multi-job

[ ] Driver ESC/POS kustom — untuk printer non-standar

[ ] Cloud print — kirim ke printer dari cloud

[ ] CUPS integration — Linux printing pipeline

[ ] Template engine — template struk terstruktur

Kesimpulan

KmpPrinter adalah solusi thermal printing multiplatform yang matang, dengan:

✅ 5 platform dalam 1 API

✅ 6 transport koneksi

✅ Receipt builder DSL yang ekspresif

✅ Monitoring real-time

✅ MIT License — bebas dipakai

Dengan 42% TypeScript dan 38% Kotlin, library ini memanfaatkan kekuatan KMP untuk memberikan performa native di setiap platform — cukup tulis sekali, cetak di mana saja.

Mulai hari ini:

BASH

git clone https://github.com/ringga-dev/kmp-printer.git
cd kmp-printer
./gradlew build

🚀 Happy printing!

KmpPrinter: Library ESC/POS Thermal Printing Multiplatform dengan Kotlin

Pendahuluan

📊 Metadata Proyek

✨ Fitur Unggulan

Multi Transport

Receipt Builder DSL

Printer Discovery (Flow-based)

Status Monitoring Real-time

🏗️ Arsitektur

🔧 Cara Install

Gradle (KMP Project)

Platform-Specific Setup

🧪 Contoh Aplikasi

📈 Kode dan Metrik

💡 Kasus Penggunaan

1. Sistem POS Restoran

2. Logistik & Warehouse

3. Aplikasi Kesehatan

🔜 Roadmap

Kesimpulan

On This Page

Author

Ringga Septia Pribadi

Share Article

Recommended Articles

AI Agent Orchestration 2026: Multi-Agent Systems untuk Otomasi Cerdas

Revolusi AI Coding Assistant 2026: Dari Copilot ke Autonomous Agent