Software requirements

The latest release of the

BlackBerry Dynamics SDK for Android

is compatible with these previous releases of the SDK:

7.1.x
7.0.x

It is recommended that you always build and test with the most recent release of the SDK to take advantage of new fixes and features.

Android

7.0 or later

Minimum API level: 24

Minimum API level: 24

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
androidx.wear:wear:1.0.0

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

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
com.google.android.gms:play-services-wearable:17.0.0

ARMv7
ARMv8
x86
x86_64

Applications must be built using

Java

8 compatibility. For more information, see java8-support.

Google Play
Services 11.0.1
Wear OS
Emulator API level 24

Android
Studio 3 or later
The following values specified in sdk/libs/handheld/gd/build.gradle. Other versions of tools will work, but the
BlackBerry Dynamics
library gradle files might need to be updated accordingly.
com.android.tools.build:gradle: 3.1.4
compileSdkVersion 29
buildToolsVersion "29.0.0"

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).

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"

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. For more information, see the BlackBerry Dynamics Launcher Framework documentation.

The

BlackBerry Dynamics SDK

and the

BlackBerry Dynamics Launcher Library

are mutually dependent. See the BlackBerry Dynamics SDK for Android Release Notes for the required version of the

BlackBerry Dynamics Launcher Library

.

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.