This article explains how to migrate from a JAR file to AAR file

Currently, the Elo Peripheral SDK is based on a Java JAR library format. However, in order to meet Android 12 restrictions and adhere to Google's preference for using Android Native Library format (AAR), we have decided to transition to the AAR format.

Here's what you need to know about this migration:

1. Enhanced Compatibility: By migrating to the AAR format, we ensure seamless integration with future versions of Android (including Android 12, which is launching for Elo devices in August 2023). This helps avoid potential issues related to API lint errors and compilation problems during app submission.
2. Improved Customization: The migration introduces changes in the library architecture, enabling better proprietary isolation and streamlined access to APIs. Please note that while we strive to maintain customization options, certain components may have limited customization capabilities compared to before.
3. Simplified Integration: The AAR format provides a standardized and efficient way to package and distribute Android libraries. It simplifies dependency management and grants easier access to APIs, facilitating smoother integration into your projects.

It is important to note that this migration is crucial for ensuring long-term compatibility and compliance with Android standards. The AAR format of SDK is included in the July (MR-28) release of Android 10. Therefore, it is strongly recommended that you update your devices to at least the MR-28 version before upgrading to Android 12.

We understand that you may have questions or concerns about this migration. We are dedicated to supporting you throughout the process. Comprehensive documentation and resources will be provided to help you smoothly transition from the JAR format to the AAR format. Our support team will be available to address any technical queries and provide assistance as needed.

Steps to migrate the JAR file to AAR file

Example Application #1: Enhanced BCR

1. Previous method to use library as JAR file (highlighted in the box below)



2. Here navigate to enhancedbcrdemo-app-build.gradle or go to Gradle Scripts build.gradle(Module)

3. Under dependencies method replace libs/eloperipherallib.jar with libs/eloperipherallibv2.aar (highlighted in the box below)



Example Application #2: Miami App

1. Previous method to use library as JAR file.(highlighted in the box below).



2. Here navigate to miami/sdk-build.gradle or go to Gradle Scripts build.gradle(Module)

3. Under dependencies method replace*.jar with *.aar (highlighted in the box below)