Software requirements

Android development

Item

Requirement

Compatibility with previous versions of the SDK
The BlackBerry Dynamics SDK for Android is compatible with these previous releases of the SDK:
  • 13.2.x
  • 13.0.x
  • 12.1.x
  • 12.0.x

Supported Android OS

Android 12 or later

AndroidX libraries
Your apps must use the AndroidX support libraries to compile successfully. The SDK supports the following minimum versions. It is recommended to use the latest stable version of each library.
  • androidx.appcompat:appcompat:1.0.0
  • androidx.cardview:cardview:1.0.0
  • androidx.constraintlayout:constraintlayout:1.1.3
  • androidx.core:core:1.0.0
  • androidx.legacy:legacy-support-v4:1.0.0
  • androidx.preference:preference:1.1.0
  • androidx.recyclerview:recyclerview:1.0.0

Build requirements

If the app project uses the SDK .jar distribution, load the shared libraries libsbgse.so and libgdndk.so.

Google Play Services

The SDK uses Google Play Services version 17.0.0 to support some of its functionality.

If your app uses the following Google Play Services libraries, verify that you are using the following minimum version or later:
  • com.google.android.gms:play-services-location:17.0.0
  • com.google.android.gms:play-services-safetynet:17.0.0

Supported CPU architectures
  • ARMv7
  • ARMv8
  • x86
  • x86_64

Java compatibility

Applications must be built using Java 17 or later.

Gradle
  • Minimum Gradle version: 8.9
  • Android Gradle Plug-in (com.android.tools.build:gradle): 8.6.1

Character encoding for build files

Build files (for example, settings.json) must use UTF-8 character encoding. Verify that the editor that you plan to use does not add non-UTF-8 characters or headers. In general, Java does not work with UTF-8-BOM (byte order mark).

Supported launch modes
Apps built with the BlackBerry Dynamics SDK for Android support the following launch modes in AndroidManifest.xml:
  • android:launchMode="standard"
  • android:launchMode="SingleTop"
  • android:launchMode="singleTask"

BlackBerry Dynamics Launcher integration

The BlackBerry Dynamics Launcher is a user-friendly interface that allows users to easily access and switch between BlackBerry Dynamics apps, configure app settings, and take advantage of other useful features. As of SDK 13.0, the BlackBerry Dynamics Launcher is now integrated with the SDK (previously, it was offered as a separate library that you had to integrate). For more information, see Implementing the BlackBerry Dynamics Launcher.

Restricted key prefix

The key prefix "blackberry" is reserved by BlackBerry and should not be used for key values, key attributes, or key elements. For more information and examples, see the Application Policies Definition in the appendix of the API Reference.

Credential manager requirements

Apps that will use the Credential Manager UI require the following updates:

In the app level module of your Gradle file (app/build.gradle), in the dependencies section, add implementation 'androidx.recyclerview:recyclerview:1.0.0'.