Software requirements

The latest release of the 

BlackBerry Dynamics SDK for Android

 is compatible with these previous releases of the SDK:

7.0.x
6.1.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

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.

The latest release of the 

BlackBerry Dynamics SDK for iOS

 is compatible with these previous releases of the SDK:

7.0.x
6.2.x

iOS

 12 or later

12.0 or later

Xcode

 10, 11

Xcode

 10 and later does not support docset archives for reference documentation. As a result, the 

BlackBerry Dynamics SDK for iOS

 does not include a docset archive.

The 

BlackBerry Dynamics Runtime

 static library requires the following frameworks and libraries in the Link Binary With Libraries build phase:

AdSupport.framework
CFNetwork.framework
CoreData.framework
CoreTelephony.framework
DeviceCheck.framework
libz.tbd
LocalAuthentication.framework
MessageUI.framework
MobileCoreServices.framework
Quartzcore.framework
QuickLook.framework
SafariServices.framework
Security.framework
SystemConfiguration.framework
WebKit.framework

If you develop a 

BlackBerry Dynamics

 app for use on both 

iPhone

 and 

iPad

 devices, use a single native bundle ID for all variations of the app. 

UEM

 will only accept a single native bundle ID.

Keychain group sharing allows groups of apps to share information that is stored on a device's keychain. Keychain group sharing is required when you are developing multiple inter-related apps. The setting is part of a project's build.

To enable keychain group sharing in an 

Xcode

 project, open the project file, navigate to the app target Capabilities tab, and turn on Keychain Sharing. You may be asked for your developer password and to choose a development team. The provisioning profiles for each app must come from the same team and must share the same App ID prefix (see row below). For the Keychain Group, specify 

com.good.gd.data

.

If the settings for keychain group sharing change, it is recommended to do a fresh reinstall of the new version of the app instead of upgrading the old version. This ensures that the new keychain settings take effect.

An App ID prefix is a unique ID that groups a collection of apps and enables those apps to share keychain and UIPasteboard data. Apps that share keychain data must have a common App ID prefix from 

Apple

.

For more information, see Technical Note TN2311: Managing Multiple App ID Prefixes.

The 

Apple

 App ID prefix is completely independent of the 

BlackBerry Dynamics

 entitlement ID.

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

The 

macOS

 platform is recommended for developing an app with the 

BlackBerry Dynamics SDK for Cordova

. Development on a 

Windows

 computer is supported only for the 

Android

 platform.

9.0

10.x (LTS) or later

Version 1.x (without 

Ionic

)

Version 7.x

Note the following limitations for 

Android

 only:

Synchronous HTTP requests via XMLHttpRequest are not supported. The requests are treated as asynchronous.
File uploads with FormData() are not supported. Use the FileTransfer plug-in (
cordova-plugin-bbd-filetransfer
) for file uploads and downloads. For more information about this plug-in, see Plug-ins available in the BlackBerry Dynamics SDK for Cordova.

Version 4

This release of the 

BlackBerry Dynamics SDK for Cordova

 is compatible with the latest releases of the 

BlackBerry Dynamics SDK for Android

 (version 7.0.x or 7.1.x) and the latest releases of the 

BlackBerry Dynamics SDK for iOS

 (version 7.0.x or 7.1.x).

It is recommended that you always build and test with the most recent release of the 

BlackBerry Dynamics SDK for Cordova

, to take advantage of new fixes and features.