That's the demo app in action, printing on a Star Micronics TSP650II
For NativeScript 7+, please use plugin version 4+
tns plugin add nativescript-star-printerAll examples below assume you're using TypeScript, but here's how to require the plugin with plain old JS as well:
var StarPrinterPlugin = require("nativescript-star-printer");
var starPrinter = new StarPrinterPlugin.StarPrinter();import { StarPrinter, SPPrinter, SPCommands } from "nativescript-star-printer";
export Class MyPrintingClass {
private starPrinter: StarPrinter;
constructor() {
this.starPrinter = new StarPrinter();
}
}If you're searching for a Bluetooth printer, enable Bluetooth in the device settings and pair/connect the printer. Then do:
this.starPrinter.searchPrinters().then(
(printers: Array<SPPrinter>) => {
console.log(`Found ${printers.length} printers`);
}, (err: string) => {
console.log(`Search printers error: ${err}`);
});The most useful property on the SPPrinter class is the portName which you will need
in other API methods.
The only other property is modelName.
Once you know the printer port name, you can connect to it.
Note that there's no need to connect if you want to print as the print function does this automatically.
this.starPrinter.connect({
portName: thePortName
}).then((result: SPPrinterStatusResult) => console.log("Connected: " + result.connected));After connecting to a printer, you can use this method to poll for the 'online' and 'paper' statuses.
this.starPrinter.getPrinterStatus({
portName: this.lastConnectedPrinterPort
}).then(result => {
const online: boolean = result.online;
const onlineStatus: PrinterOnlineStatus = result.onlineStatus;
const paperStatus: PrinterPaperStatus = result.paperStatus;
});Once you've got the port of the printer you want to print to, just do:
this.starPrinter.print({
portName: this.selectedPrinterPort,
commands: commands
});So what are those commands? Let's recreate the fake receipt below to answer that (see the TypeScript definition for all options):
const image = ImageSource.fromFile("~/res/mww-logo.png");
// Note that a standard 3 inch roll is 48 characters wide - we use that knowledge for our "columns"
let commands = new SPCommands()
.image(
image,
true, // diffuse
true // align center (set to 'false' to align left)
)
// alternatively, you can use imagePositioned for a bit more control (on Android this behaves the same as 'image' though)
.imagePositioned(
image,
80, // width
20, // position
true, // both scale
true, // diffuse
true // align center (set to 'false' to align left)
)
.alignCenter()
.text("My Awesome Boutique").newLine()
.text("In a shop near you").newLine()
.setFont("smaller")
.text("Planet Earth").newLine()
.setFont("default")
.newLine()
.text("Date: 11/11/2017 Time: 3:15 PM")
.horizontalLine() // you can pass in the character and the nr of characters (use 48 for a 3" roll, 42 for a smaller one)
.newLine()
.textBold("SKU Description Total").newLine()
.text("300678566 Plain White Tee €10.99").newLine()
.text("300692003 Black Dénim €29.99").newLine()
.text("300651148 Blue Denim €29.99").newLine()
.newLine()
.newLine()
.barcode({
type: "Code128",
value: "12345678",
width: "large",
height: 60,
appendEncodedValue: false
})
.newLine()
.cutPaper();
this.starPrinter.print({
portName: this.selectedPrinterPort,
commands: commands
});In case a cash drawer is connected via the UTP (network) connector of the Star printer, you can open the drawer from your code!
this.starPrinter.openCashDrawer({
portName: this.selectedPrinterPort
});iOS 10+ requires a permission popup when connecting (the first) time to a Bluetooth peripheral explaining why it needs to connect.
You can provide your own reason by adding something like this to app/App_Resources/ios/Info.plist:
<key>NSBluetoothPeripheralUsageDescription</key>
<string>My reason justifying fooling around with your Bluetooth</string>To not crash your app in case you forgot to provide the reason this plugin adds an empty reason to the .plist during build. This value gets overridden by anything you specified yourself. You're welcome.
On iOS you want to run this on a real device.
Possibly add more print formatting options.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent