ntbp_plugin 2.0.0 copy "ntbp_plugin: ^2.0.0" to clipboard
ntbp_plugin: ^2.0.0 copied to clipboard

A comprehensive Flutter plugin for thermal Bluetooth label printing with advanced features including gap detection, precise positioning, and support for multiple label formats.

Changelog #

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

2.0.0 2024-12-XX #

Added #

  • Three-Line Text Support - Enhanced label printing with customer name, position, and additional info
  • Perfect Text Alignment - All text lines start at the same left position as QR code
  • Enhanced Positioning System - Professional-quality label layout with precise positioning
  • ESC/POS Printer Support - TSPL forced approach for ESC/POS compatible printers
  • Improved Gap Detection - Better buffer management and frame handling
  • Optimized Text Spacing - 8mm gap after QR code, 4mm between text lines

Changed #

  • API Enhancement - Updated printSingleLabelWithGapDetection to support three text parameters
  • Positioning Algorithm - Improved QR code and text positioning for better visual alignment
  • Buffer Management - Enhanced clearing strategies for more reliable printing
  • Connection Handling - Simplified and more robust Bluetooth connection logic

Fixed #

  • Text Overlap Issues - Resolved text positioning problems that caused overlap with QR codes
  • Multiple Label Printing - Fixed issues with text not appearing on multiple labels
  • Positioning Accuracy - Corrected text alignment to start exactly at QR code left edge
  • Line Spacing - Optimized vertical spacing between text lines for better readability

Technical Improvements #

  • Kotlin Implementation - Enhanced Android native code with better positioning logic
  • Test Coverage - Updated test files to match new API signatures
  • Documentation - Comprehensive README update with new features and examples
  • Error Handling - Improved error messages and debugging information

1.0.0 2024-01-XX #

Added #

  • Initial Release - Comprehensive thermal Bluetooth label printing plugin
  • Bluetooth Connectivity - Support for both Classic Bluetooth (SPP) and BLE
  • Thermal Printing - TSPL language support for professional label printing
  • Smart Positioning - Automatic content centering based on label dimensions
  • Gap Detection - Intelligent label boundary detection and frame management
  • Multiple Formats - QR codes, barcodes, text, and combined content printing
  • Batch Processing - Sequence printing with proper label separation
  • Buffer Management - Advanced buffer clearing strategies for reliable printing
  • Cross-Platform Support - Full Android and iOS implementation
  • Device Pairing - PIN code handling and pairing management
  • Connection Management - Robust connection strategies with fallbacks
  • Error Handling - Comprehensive error management and user feedback
  • Performance Optimization - Connection pooling and command batching

Features #

  • Single Label Printing - Print individual labels with gap detection
  • Multiple Labels Printing - Batch print multiple labels with different content
  • Custom Label Sizes - Support for various label dimensions (2" to 4.65" width)
  • DPI Configuration - Support for 203 DPI and higher resolution printers
  • Text Customization - Configurable text size and positioning
  • Copy Management - Print multiple copies of labels
  • Paper Configuration - Automatic paper size detection and configuration
  • Printer Status - Real-time printer status monitoring
  • Buffer Operations - Clear, feed, and manage printer buffers

Technical Features #

  • Platform Interface - Clean abstraction layer for cross-platform development
  • Method Channels - Efficient Flutter-to-native communication
  • Kotlin Implementation - Modern Android development with coroutines
  • Swift Implementation - Native iOS development with CoreBluetooth
  • Comprehensive Testing - Unit tests and integration tests
  • Documentation - Complete API reference and integration guides

Supported Platforms #

  • Android - API level 26+ (Android 8.0+)
  • iOS - iOS 12.0+
  • Flutter - 3.19.0+

Supported Printers #

  • TSPL-Compatible - N41, N42, and similar thermal label printers
  • Resolution - 203 DPI (8 dots/mm) and higher
  • Label Sizes - 2" (50mm) to 4.65" (118mm) width
  • Media Types - Die-cut labels, continuous paper, black mark paper

Documentation #

  • README.md - Comprehensive overview and quick start
  • API Reference - Complete method documentation
  • Integration Guide - Step-by-step integration instructions
  • UI Implementation Guide - UI framework examples
  • Label Printing Flow - Detailed printing process documentation
  • Troubleshooting Guide - Common issues and solutions
  • Development Guide - Contributing and development setup
  • Release Preparation Guide - Release process and checklist

0.0.1 2024-01-XX #

Added #

  • Initial plugin structure
  • Basic Bluetooth connectivity
  • Basic printing functionality
  • Platform interface setup

Note: This changelog follows Keep a Changelog format and Semantic Versioning principles.

For detailed information about each release, please refer to the GitHub releases page.

1
likes
140
points
31
downloads

Publisher

unverified uploader

Weekly Downloads

A comprehensive Flutter plugin for thermal Bluetooth label printing with advanced features including gap detection, precise positioning, and support for multiple label formats.

Repository (GitHub)
View/report issues

Documentation

Documentation
API reference

License

MIT (license)

Dependencies

flutter, permission_handler, plugin_platform_interface

More

Packages that depend on ntbp_plugin

Packages that implement ntbp_plugin