Printer SDK

Introduction

The Printer SDK is a library designed to simplify the integration of receipt printing functionality into Android applications. This SDK is for printing receipt information for Dejavoo Gateway-powered P series terminals.

Integrating the Printer SDK

This guide details the steps to integrate the Printer SDK into your Android project.

Prerequisites

Here are the prerequisites required to integrate the Printer SDK into your Android project.

• Your Android project

• Printer SDK kit

Downloading the Printer SDK

1. Locate the printer_v3.0.aar file file provided with your Printer SDK kit.

2. Copy the printer_v3.0.aar file file to your project directory.

Configuring Gradle Dependencies

1. Open your project's build.gradle file (located at the module level).

2. Add the following dependencies within the dependencies block:

implementation files "libs/printer_v3.0.aar"

Synchronizing Gradle

Click Sync Project with Gradle Files in Android Studio. This process updates your project with the Printer SDK and any additional dependencies you've included.

Accessing the Printer

Follow the steps mentioned below to access the printer:

1. Place the provided .aar file into the lib folder of your project.

2. In the app level build.gradle file, add the following line:

implementation files'libs/printer_v3.0.aar'

3. Use the following code to initialize the printer. After initialization, set the provided callbacks to handle responses for print completion or failure.

private IntentPrintApplication intentPrintApplication = new IntentPrintApplication(this);
 
intentPrintApplication.setLaunchInterface(new PrintLauncherInterface() {
   @Override
   public void onPrintSuccess(PrintResult printResult) {
       Log.e("printer", "onPrintSuccess");
 
   }
 
   @Override
   public void onPrintFailed(PrintErrorResult errorResult) {
       Log.e("printer", "onPrintFailed");
 
   }
});

4. Use the code below to launch the printer with the provided printer data.

intentPrintApplication.launchPrinter(request);

5. The format of the printer input should follow the structure shown below:

The request should contain: <request><printer width=\"24\"> </printer></request> tags.

Below is a sample request:

String request = "<request><printer width=\"24\">\n<C>Happy Restaurant</C><L>10/05/23</L><R>04:07</R><C>Thank you</C><B><C>MERCHANT COPY</C></B><IMG></IMG> </printer></request>";

Response tags

PrintResult (a model class for success response)

PrintErrorResult (a model class for failure response)