Skip to content
Help and manuals  >  Enterprise services  >  BlackBerry Dynamics SDK for iOS  >  Release notes and advisories

BlackBerry Dynamics SDK for iOS version 4.0

What's new in BlackBerry Dynamics SDK for iOS version 4.0

Feature

Description

Changes to software requirements

This release of the SDK adds support for Xcode 9 and Swift 4.0. The updated software requirements are:
  • Xcode 8 or later
  • iOS SDK 10.0 or later
  • Deployment target: iOS 10 or later
  • Swift 3.0 or later
  • Objective-C: latest versions supported by Apple

URL scheme requirement

Each app must add a custom URL scheme to the Info.plist file that consists of the bundle identifier with ".sc3" appended. Include the declaration in the same custom URL type declaration as the existing mandatory declarations (for example, the .sc2 scheme).

Support for Face ID

This release of the SDK adds support for Face ID. An administrator can enable or disable the feature in a BlackBerry Dynamics profile in UEM or security policy in Good Control. For apps that are built for iOS 11 or later, each application must add the NSFaceIDUsageDescription key to the Info.plist file. For more details about Face ID, see the BlackBerry Dynamics SDK for iOS API Reference.

If a BlackBerry Dynamics app is using version 4.0 of the SDK and the management console has not been upgraded to UEM 12.8 or Good Control 5.0, access to the Face ID feature is controlled by the Touch ID setting (Allow Touch ID for Idle Unlock).

New options for BlackBerry Dynamics library version compliance

In a compliance profile or compliance policy, an administrator can enable the BlackBerry Dynamics library version verification compliance rule to specify an enforcement action if a BlackBerry Dynamics app is using a version of the BlackBerry Dynamics library that is not permitted. The available enforcement actions are "Do not allow BlackBerry Dynamics apps to run" and "Delete BlackBerry Dynamics app data."

In previous releases of UEM, standalone Good Control, and the SDK, BlackBerry Dynamics apps could be blocked or deleted unintentionally if an app used a version of the library that was not available in the version list (for example, a pre-release version of the SDK).

In UEM, by default the BlackBerry Dynamics library version verification compliance rule is not selected and all versions are permitted. An administrator can enable this option and select specific versions to disallow.

In standalone Good Control 5.0, the following options have been added to this compliance rule:
  • Allow all BlackBerry Dynamics library versions: Apps that use any version of the SDK library are allowed. If this option is enabled, the administrator cannot select specific versions to allow or disallow. By default, this option is disabled.
  • Allow unlisted BlackBerry Dynamics library versions: Apps that use versions of the SDK library that are newer than the latest version listed in the compliance rule are allowed. The administrator can still allow or disallow specific versions of the library from the version list. By default, this option is enabled.

Prevent screen recording and sharing

This release of the SDK adds support for preventing screen recording and sharing. In a BlackBerry Dynamics profile in UEM or security policy in standalone Good Control, a new Data Leakage Prevention option, Prevent iOS Screen Recording and Sharing, is enabled by default. This setting applies toiOS 11 or later.

If an app uses the BlackBerry Dynamics SDK 4.0 or later and the management console is not upgraded to UEM 12.8 or Good Control 5.0, access to the iOS Screen Recording and Sharing setting is controlled through the Data Leakage Prevention setting (Prevent copy from BBD apps into non-BBD apps).

Support for the Apple Universal Clipboard

This release introduces support for secure cut, copy, and paste operations using the Apple Universal Clipboard. Users can copy and move data between BlackBerry Dynamics apps and devices that follow Apple Continuity system requirements. The apps and devices must be activated for the same user account on the same instance of BlackBerry UEM or standalone Good Control.

For more information about the Apple Universal Clipboard, see support.apple.com to read Set up Universal Clipboard.

App UI restrictions

The BlackBerry Dynamics Runtime monitors the app UI to enforce a number of enterprise security policies configured in BlackBerry UEM or standalone Good Control. For example, a security policy may require the user to enter a password when the app transitions from the background to the foreground, or may lock the app UI after a certain period of inactivity.

The app UI must follow certain restrictions to enable monitoring by the BlackBerry Dynamics Runtime. For a complete explanation of the restrictions, open the BlackBerry Dynamics SDK API Reference for your platform and see the section “Application User Interface Restrictions” in the appendix.

Ban common passwords for the BlackBerry Dynamics container

In BlackBerry UEM 12.8 or standalone Good Control 5.0, administrators can use a BlackBerry Dynamics profile (UEM) or a security policy (Good Control) to upload a text file that lists banned passwords for the BlackBerry Dynamics container (for example, “password”). Users cannot use the specified passwords when setting a password for the container. Administrators can use this feature to protect against common or weak passwords that do not meet security standards. This feature is compatible with existing password complexity features.

Please note the following restrictions:
  • The banned passwords text file must contain UTF-8 values only.
  • The file can contain a maximum of 10,000 passwords.
  • The maximum file size is 1 MB.
  • Banned passwords with more than 14 characters are not saved.
  • When using standalone Good Control, you cannot specify a banned password that consists only of spaces, and leading and trailing spaces are trimmed. These restrictions do not apply if you are using BlackBerry UEM.

Changes to support configuration update notifications

Previously, the GDAppEvent class was used to notify the app of changes in the state of the BlackBerry Dynamics Runtime and its configuration, including UI locking, authorization withdrawal from a wipe command, changes to app configuration settings or policy settings, and so on. In this release, the GDState class handles the configuration update notifications that used to be handled by GDAppEvent. The GDState class includes new additions to support configuration notifications for services-related changes, app-specific policy changes, entitlement changes, and other settings changes from the enterprise. GDState.h also includes updates to support these notifications.

For full details, see the GDState class in the BlackBerry Dynamics SDK for iOS API Reference.

Certificate Credential Import interface

This release includes a new programming interface for importing certificate credentials into the secure store. For more information, in the BlackBerry Dynamics SDK API Reference, navigate to the class list, then open the GDData page and see the Certificate Credential Import link.

Deprecated items

  • The GDServiceProviderType enum is deprecated and has been replaced with GDServiceType.

Class

Deprecated methods

GDFileStat

  • The GDFileStat struct and header have been deprecated.

GDHttpRequest

  • The class and its methods are deprecated. Use the methods of NSURLConnection and NSURLSession instead.

GDiOS

  • getWindow: This functionality is now handled automatically by the BlackBerry Dynamics Runtime. If the app requires a reference to the app window, it can use the existing app delegate 'window' property.
  • getServiceProvidersFor:andVersion:andType: : Replaced with getServiceProvidersFor:andVersion:andServiceType:
  • launchOptions property

GDService

GDServiceClient

  • bringToFront:error: Replaced by the new method bringToFront:completion:error

NSMutableURLRequest(GDNET)

  • setAuthorisationCredentials (British spelling)
  • failOnAuthorisationChallenge (British spelling)
  • disableHostVerification
  • disablePeerVerification

Fixed issues

The following issues are fixed in this release:
  • Pressure support for the Apple Pencil did not work as expected. (FIRST-15049)
  • On iOS 11, when a user tried to view a streaming video in a BlackBerry Dynamics app, the video might not have played as expected. (FIRST-14626)
  • On iOS 11, drop-down lists in a BlackBerry Dynamics app might not have displayed as expected. (FIRST-14609)

Known issues

  • Easy activation does not complete successfully if the app is open in split-view and a password change is required by the banned passwords rule in the BlackBerry Dynamics profile (UEM) or a security policy (standalone Good Control). (GD-31211)
  • If you enable Data Leakage Prevention policies in the management console, when a user pastes copied text, the text may lose some of its previous formatting. (GD-32734)