to top
Datalogic APIs

Package Index - Introduction to the Datalogic Android SDK 1.42

Welcome to the Datalogic Android SDK documentation. This SDK offers a comprehensive set of APIs to help developers fully leverage Datalogic devices in enterprise environments. This guide will help you navigate key functionalities, providing links to specific packages and more detailed descriptions to facilitate your development process. Below is an organized overview of the SDK's key capabilities.

This is particularly useful in enterprise environments where large-scale device fleets need to be managed centrally.

In order to use these API do not forget to add the following "uses-library" tag to your application manifest.

<uses-library
        android:name="com.datalogic.device"
        android:required="true" />
Remember to switch the selected Revision number in accordance with your device firmware and installed Android Datalogic SDK update.

1. Device Configuration

The Configuration Manager is a crucial component designed to facilitate the management and customization of device settings on Datalogic devices. This manager provides developers with an interface to access and modify various configuration parameters, allowing for optimized device behavior tailored to specific application requirements. This gives full control over hardware and system settings for optimal performance in enterprise use cases, including scanner settings, advanced networking fine-tuning, power management options, and user interface preferences.

The configurable properties are defined in the PropertyID and cover a wide range of system features.

Package: com.datalogic.device.configuration

2. Configuration Profiles

The Profile Manager is designed to facilitate the management and the configuration of Datalogic devices. In particular, a profile is a curated collection of configuration settings that define the operational parameters for a given context. Using the Profile Manager significantly streamlines app development by externalizing configuration settings to the system administrators. This flexibility allows applications to avoid the complexities of device configuration; instead, they can rely on predefined profiles to automatically find the appropriate runtime context, ensuring that the device operates optimally according to specific operational needs.

Additionally, this approach enables system administrators to define a set of profiles and load the appropriate one at runtime based on the app currently in the foreground (or any other desired condition), allowing the device to adapt its behavior to the user’s current operational context.

Key features include:

  • Profile Management: The Profile Manager allows for the creation, modification, and deletion of profiles, enabling applications to manage different configurations based on user requirements or operational scenarios.
  • Event-Driven configuration: Developers can associate profiles with specific events (such as an app entering the foreground or background, battery lower than a threshold, networking coverage, etc.), allowing the device to automatically load or unload profiles. This capability enables the device to adapt its settings to the current usage scenario, thereby modifying its behavior and enhancing performance efficiency.

3. Application Management

The App Manager and the Package Installer offer robust administrative control over enterprise applications on Datalogic devices. These functionalities allow system administrators to manage the application lifecycle seamlessly, without requiring user intervention.

Key features include:

  • Silent Management: Install, update, or remove applications quietly in the background.
  • Application Control: Enable or disable specific applications to determine which apps are accessible to users, ensuring adherence to organizational policies.
  • Permission Management: Grant necessary permissions or revoke those that are not needed.
  • Notification Customization: Manage notification behavior by customizing notification channels, enabling businesses to prioritize alerts and reduce distractions.
  • Battery Optimization Management: Prevent certain applications from malfunctioning due to battery optimization settings.

Package: com.datalogic.device.app

4. Barcode Scanning and Data Collection

The Barcode Manager provides a comprehensive framework for integrating barcode scanning capabilities into Android applications. This manager facilitates the control and configuration of various barcode scanning functionalities, making it easier for developers to implement efficient scanning solutions.

Key features include:

  • Barcode Scanning Control: The Barcode Manager allows developers to initiate and manage barcode scanning sessions programmatically. This includes starting and stopping scans based on application needs.
  • Configuration Options: Developers can configure scanning parameters, such as the types of barcodes to recognize, scan sensitivity, and decoding options. This flexibility enables tailored scanning experiences for different applications. It supports a wide range of barcode formats, ensuring compatibility with various scanning needs and scenarios.
  • Data Retrieval: The manager provides several methods to receive scanned data, such as Intent or Java listener interfaces, which allow applications to receive scanned data directly within their code, Wedge and Web Wedge, which enable scanned data to be injected directly into input fields or to be directed to web applications, making it appear as though it was typed in by the user.
  • Profiles: The Barcode Manager works seamlessly with the Configuration Manager and Profile Manager to allow for advanced configurations and customized behaviors based on specific application contexts in the foreground.

Scanning capability configuration can be configured with both Barcode Manager and Configuration Manager.

Package: com.datalogic.decode

5. Keyboard & Trigger Management

The Keyboard Manager provides developers with a set of interfaces for configuring and managing input on Datalogic devices, such as the touchscreen, hardware triggers, and the keyboard. The ability to customize these inputs allows devices to be adapted to specific operational scenarios, particularly in enterprise environments.

Key Features Include:

  • Key Mapping: Customizing the behavior of keys, allowing developers to redefine the actions associated with specific keys. This is particularly useful in enterprise applications where custom shortcuts or specific workflows are necessary. By remapping keys, developers can streamline user interactions, making the application more intuitive and tailored to specific operational tasks.
  • Trigger Management: Enabling or disabling specific Datalogic buttons to initiate designated actions or to wake the device from suspend mode.
  • Keyboard Layouts: Configuring different keyboard layouts to suit various needs.

6. Battery Management

The Battery Manager provides essential functionalities for managing and monitoring battery-related events on Datalogic devices.

Key features include:

  • Charging Profile: This feature allows users to configure and retrieve the charging behavior of the device's battery. It provides insights into the charging status, helping to optimize battery usage and extend battery life.
  • Monitor Battery Metrics: The DLBatteryManager facilitates real-time monitoring of various battery metrics, including voltage, temperature, and remaining capacity. This functionality empowers developers to integrate analytics into their applications, enabling them to respond effectively to changes in battery status.
  • Manufacturing Info: The Battery Manager also provides access to detailed manufacturing information about the battery, such as the battery type, model, and serial number. This information can be useful for diagnostics and quality control purposes.
  • Battery Swap Event: The Battery Manager can detect and handle battery swap events. This is particularly useful in scenarios where batteries are replaceable, ensuring that the system responds appropriately when a new battery is inserted.

Package: com.datalogic.device.battery

7. Cradle Functionalities

The Cradle Manager provides a comprehensive set of tools to manage and interact with Datalogic devices when docked in a Cradle.

Key features include:

  • Connection: The Cradle package allows applications to monitor the connection state between the device and the Cradle, providing real-time feedback on whether the device is docked or undocked.
  • Power: It facilitates power management features, enabling the device to charge efficiently while docked, ensuring that the battery remains optimally charged for continuous use.
  • Locking/Unlocking: The package provides methods to lock or unlock the device while it is in the Cradle, allowing for secure operation and preventing unauthorized access when docked.
  • Firmware Upgrades: It offers a straightforward mechanism to perform firmware upgrades programmatically, ensuring that the cradle can be kept up to date with the latest enhancements and bug fixes without manual intervention.

These functionalities allow developers to create robust applications that effectively manage device interactions with the Cradle, ultimately improving operational efficiency and user satisfaction in enterprise settings.

Package: com.datalogic.device.cradle

8. Datalogic Extended Intents

The Datalogic SDK offers a set of extended Android Intents that enhance application functionality on Datalogic devices. These intents enable developers to leverage specific device capabilities, streamlining the integration of advanced features into their applications.

Key features include:

  • Scanning Intents: Initiate barcode scanning processes, allowing applications to receive scanned data directly through intents.
  • Configuration Intents: Configure scanner settings, enabling customization of scan parameters such as barcode formats, sensitivity, and decoding options.
  • Battery Management Intents: Monitor battery status and manage power settings, ensuring efficient battery usage and providing real-time updates on battery metrics.
  • Cradle Intents: Monitor and manage the Cradle connection state, including notifications for when the device is docked or undocked. Additionally, it allows for locking/unlocking the device in the Cradle and performing firmware upgrades.
  • Firmware Upgrade Intent: Provides an intent specifically for performing firmware upgrades on the device, offering a simple and programmatic way to update the device efficiently.

These extended intents provide developers with powerful tools to create more responsive and feature-rich applications tailored to the unique capabilities of Datalogic devices.

9. Device info

The System provides essential information about the device. Specifically, developers can obtain the Device ID, Name, Product and Serial numbers, which uniquely identify the device within a network or system. Additionally, it provides helpful information such as the Hardware revision, Firmware and SDK versions, providing developers and system administrators full control and management of a fleet of Datalogic devices.

Package: com.datalogic.device.info

Packages table

Below the list of packages. See all API classes.

com.datalogic.cradle

Provides basic classes to interact with the cradle.

com.datalogic.decode

Provides basic classes to interact with the scanner.

com.datalogic.decode.configuration

Contains high-level classes encapsulating the overall Datalogic device configuration model.

com.datalogic.decode.utils

Provides utility classes related to decoding.

com.datalogic.device

This package contains sub packages capable of configuring and controlling completely the Datalogic device.

com.datalogic.device.app
com.datalogic.device.battery

This package contains the DLBatteryManager used to read the battery data information and setup the preferred charging profile.

com.datalogic.device.configuration

This package contains model classes and interfaces to handle the different properties.

com.datalogic.device.display

This package contains the DLSecondDisplayManager used to setup up and manage the 2nd Display features.

com.datalogic.device.info

Provides classes to read and discover specific device capabilities and infos.

com.datalogic.device.input

Through the included classes it's possible to control and configure several input methods.

com.datalogic.device.location

Contains classes to manage the device localization capabilities.

com.datalogic.device.nfc

Support for managing the NFC chip.

com.datalogic.device.notification

Provides access to notification mechanisms.

com.datalogic.device.power

Contains classes to manage device's power consumption.

com.datalogic.device.wifi

Contains classes to manage Wi-Fi connectivity.

com.datalogic.softspot

Provides basic classes and APIs to interact with SoftSpot technology.