Software requirements

The latest release of the

BlackBerry Dynamics SDK for iOS

is compatible with these previous releases of the SDK:

9.2.x
9.1.x
10.0.x
10.1.x
10.2.x

iOS

14 or later

13.0 or later

Xcode

12 or 13

The

BlackBerry Dynamics Runtime

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

AdSupport.framework
AuthenticationServices.framework
AVFoundation.framework
BlackBerryCerticom.framework
BlackBerryCerticomSBGSE.framework
CFNetwork.framework
CoreData.framework
CoreServices.framework
CoreTelephony.framework
CryptoTokenKit.framework
DeviceCheck.framework
libz.tbd
LocalAuthentication.framework
MessageUI.framework
Quartzcore.framework
QuickLook.framework
SafariServices.framework
Security.framework
SystemConfiguration.framework
WebKit.framework

In the Info.plist file, add the key "Privacy - Camera Usage Description" with the value "Allow camera usage to scan a QR code". This is not required if the app already uses the camera for its own purposes.

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

. Also, if you intend to use crypto tokens in your app, specify

com.apple.token

.

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.