Skip to main content

AD Device Manager SDK

Build powerful label printing and barcode scanning into your Android app — in an afternoon.


What is the AD Device Manager SDK?

The AD Device Manager SDK allows application developers to integrate their apps with Avery Dennison's Pathfinder devices. The SDK was built from the ground up with the following goals in mind:

  • Developer-Friendly API: A simple, intuitive API that simplifies integration with your application.
  • Enhanced Observability: Easier troubleshooting via SLF4J logging.
  • Clear Documentation: Easy-to-follow guides and comprehensive documentation that aim to speed up the integration process.

Whether you're building inventory management, retail price marking, or warehouse logistics — we've got you covered.

// This is all it takes to print a label
printerAdapter.print("Template.ngt", "PRICE=4.99;SKU=12345", 1);

What's in the Box

The SDK distribution package is designed to provide you with everything you need for a successful integration:

├── lib/                      → Core libraries to add to your project
│ ├── addevicemanager.aar → Core SDK
│ └── references/
│ └── edge.aar → Required dependency

├── docs/
│ ├── tutorials/ → Practical guides to use the SDK
│ └── reference/ → Full API reference (Javadoc)

├── PF-QuickStart/
│ ├── PFQuickstartApp.apk/ → Install and explore scanning and printing immediately
│ └── source/ → Full source code of the Quick Start app

└── PF-Reference/
├── PfReferenceApp.apk → Install and explore immediately
└── source/ → Full source code of the Reference app— copy, learn, adapt

lib/

Here you will find the core SDK library file: addevicemanager.aar. This Android Archive (AAR) file is the main artifact that must be imported into your Android project to integrate the printer's functionalities. To do so, you'll typically add it to your project's libs/ folder and declare it as a dependency in your build.gradle file.

Additionally, a references/ sub-directory can be found here. This contains the edge.aar dependency that is required in case you're integrating with the next-gen Pathfinder Edge device. You must import this library into your project alongside the core SDK.

docs/

This folder contains all documentation for the SDK:

  • tutorials/ — Practical guides organized by topic:

    • Onboarding: Introduction to Android development concepts and quick-start patterns
    • Core Guides: Comprehensive walkthroughs for common tasks including device connection, scanning, and printing
  • reference/ — Complete API reference generated with Javadoc, providing detailed information on all public classes, methods, parameters, and return types. Open index.html in your browser to view it.

PF-QuickStart/

A lightweight reference application demonstrating basic SDK usage:

  • PFQuickstartApp.apk — Pre-built APK ready to install on an Android device. Use it to immediately explore basic scanning and printing features.
  • source/ — Full source code of the Quick Start application, serving as a reference implementation showing how to:
    • Set up project dependencies
    • Initialize the SDK in an Android application
    • Call basic methods for Bluetooth device discovery and connection, scanning, and printing

PF-Reference/

A comprehensive reference application showcasing advanced SDK capabilities:

  • PfReferenceApp.apk — Pre-built APK ready to install and explore.
  • source/ — Full source code of the Reference app. Copy, learn from, and adapt this code for your own Android application integration.

Supported Devices

DeviceTemplatesNotes
Pathfinder Edge.ngtLatest generation, recommended
Pathfinder 6059/6140.lntRequires LNT templates

Requirements

  • Android 7.1 (API Level 25) or higher
  • Bluetooth enabled
  • A Pathfinder device

Documentation Structure

This documentation is organized to help you get up and running quickly:

Onboarding

GuideWhat You'll Learn
Android FundamentalsCore Android concepts for SDK integration
Quick StartZero to Print in minutes

Core SDK Guides

GuideWhat You'll Learn
Getting StartedSDK setup, permissions, and connection
Resource ManagementUploading templates and fonts
PrintingTemplates, TSPL basics, printing labels
ScanningBarcode scanning and symbology configuration
CallbacksConnection state, printer status, progress
LoggingDebugging and monitoring
TelemetryDevice analytics and usage data
Error HandlingError codes and recovery strategies
Firmware ManagementCheck, validate, and update firmware
NFCNFC capabilities
RFIDRFID tag reading and writing

Need Help?

  • API Reference: Click here to open it in your browser
  • Source Code: Explore PF-QuickStart/source/ or PF-Reference/source/ for a glimpse of what's possible
  • Support: Contact your Avery Dennison representative