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).
$ npm install react-native-zebra-bt-printer --save
$ react-native link react-native-zebra-bt-printer
- In XCode, in the project navigator, right click
Libraries
➜Add Files to [your project's name]
- Go to
node_modules
➜react-native-zebra-bt-printer
and addRCTZebraBTPrinter.xcodeproj
- In XCode, in the project navigator, select your project. Add
libRCTZebraBTPrinter.a
to your project'sBuild Phases
➜Link Binary With Libraries
- Run your project (
Cmd+R
)<
- 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 thegetPackages()
method
- 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')
- Insert the following lines inside the dependencies block in
android/app/build.gradle
:compile project(':react-native-zebra-bt-printer')
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');
}
}