/react-native-zebra-bt

React native library, built to work with Portable Zebra Bluetooth Printers.

Primary LanguageObjective-C

react-native-zebra-bt-printer

This library is built for react native to work with Portable Zebra Bluetooth Printers. This library uses the libraries provided by Zebra. It has been tested with the QLN220, but should work with other QLN series printers that have bluetooth (non BLE mode).

Getting started

$ npm install react-native-zebra-bt-printer --save

Mostly automatic installation

$ react-native link react-native-zebra-bt-printer

Manual installation

iOS

  1. In XCode, in the project navigator, right click LibrariesAdd Files to [your project's name]
  2. Go to node_modulesreact-native-zebra-bt-printer and add RCTZebraBTPrinter.xcodeproj
  3. In XCode, in the project navigator, select your project. Add libRCTZebraBTPrinter.a to your project's Build PhasesLink Binary With Libraries
  4. Run your project (Cmd+R)<

Android

  1. Open up android/app/src/main/java/[...]/MainActivity.java
  • Add import com.cyclelution.RCTZebraBTPrinterPackage; to the imports at the top of the file
  • Add new RNMyFancyLibraryPackage() to the list returned by the getPackages() method
  1. Append the following lines to android/settings.gradle:
    include ':react-native-zebra-bt-printer'
    project(':react-native-zebra-bt-printer').projectDir = new File(rootProject.projectDir, 	'../node_modules/react-native-zebra-bt-printer/android')
    
  2. Insert the following lines inside the dependencies block in android/app/build.gradle:
    compile project(':react-native-zebra-bt-printer')
    

Usage

API:

Method Description
printLabel(printerSerial, userCommand) Prints data on zebra bt printer. userCommand is presented in CPCL printer programming language. Returns a promise with result
checkPrinterStatus(printerSerial) Checks if printer is ready to print. Returns a promise with result

You must pair your printer first with the device.

iOS requires the printer serial#.

Android requires the MAC ADDRESS.

import ZebraBTPrinter from 'react-native-zebra-bt';

const printLabel = async () => {

  console.log('printLabel APP');

  if(userText1 === ''){
    Alert.alert('Your label seems to be missing content!');
    return false;
  }


  //Store your printer serial or mac, ios needs serial, android needs mac
  const printerSerial = await AsyncStorage.getItem('printerSerial');

  //check if printer is set
  if (printerSerial !== null && printerSerial !== '') {

    const lineSeparator = '\r\n';
    // userCommand is presented in CPCL printer programming language
    // full CPCL programming guide can be found here https://www.zebra.com/content/dam/zebra/manuals/en-us/printer/cpcl-link-os-pg-en.pdf
    const userCommand = `0 200 200 210 1${lineSeparator}TEXT 4 0 30 40 This is a CPCL test.${lineSeparator}FORM${lineSeparator}PRINT${lineSeparator}`

    ZebraBTPrinter.printLabel(printerSerial, userCommand).then((result) => {

      if (result === true) {
        Alert.alert('Successfully printed');
      } else {
        Alert.alert('Print failed, please check printer connection');
      }

    })
    .catch((err) => console.log(err.message));

  } else {

    Alert.alert('Print failed, no printer setup found');

  }
}