Skip Navigation

BlackBerry Dynamics SDK for iOS
version 9.1

What's new in the
BlackBerry Dynamics SDK for iOS
version 9.1

Changes to SDK and software requirements
Feature
Description
Changes to software requirements
  • iOS
    12 is no longer supported.
  • If you use the static framework, you must add AuthenticationServices.framework in the Link Binary With Libraries build phase.
  • The SDK dynamic framework is no longer in beta and is now fully supported. It is a best practice to use the dynamic framework. For more information, see the Development Guide.
Changes to accessibility
Voice over accessibility for SDK UI screens is now supported.
Changes to NSURLSession cookie storage
This release adds enhancements to NSURLSession cookie storage and support for HTTPCookieStorage property in the NSURLSessionConfiguration class. For more information, see NSURLSession Support in the BlackBerry Dynamics SDK for iOS API reference.
Support for NSURLSessionDownloadTask
This release supports NSURLSesssionDownloadTask, with the following limitations:
  • NSURLSessionResponseBecomeDownload is not supported. If you try to convert NSURLSessionDataTask to NSURLSessionDownloadTask using NSURLSessionResponseBecomeDownload, a log error will indicate that it is not supported. The download process will continue using NSURLSessionDataTask.
  • Resuming a download in progress after an app restart is not supported. If the app is restarted and the download resumes using downloadTaskWithResumeData, the download process restarts from the beginning.
Changes to user prompts for biometric authentication
Previously, if a user with a
Persona Mobile
entitlement was assigned a new
BlackBerry Dynamics
profile with a different configuration for biometric authentication (turned off in the original profile and enabled in the new profile, or enabled in the original profile and turned off in the new profile), a
BlackBerry Dynamics
app prompted the user every time the biometrics feature needed to be authorized and every time the feature was turned off.
In SDK version 9.1, a user with a
Persona Mobile
entitlement is prompted to authorize biometrics the first time the feature is enabled and is not prompted on subsequent changes of this setting. The previous authorization is saved and used if the feature is enabled again.
New administrative and security features
Feature
Description
Activate
BlackBerry Dynamics
apps using
BlackBerry Enterprise Identity
This SDK release and
UEM
12.14 add support for using
BlackBerry Enterprise Identity
to activate
BlackBerry Dynamics
apps. This supports the use of Active Directory, Ping Identity or Okta for activation through
Enterprise Identity
. For more information, see the BlackBerry Enterprise Identity content.
This featured is not supported for user accounts that were created using the legacy
Good Control
console or the legacy SOAP APIs.
Optional certificate enrollment
Previously, users could not access a
BlackBerry Dynamics
app unless they completed the certificate enrollment process. In
UEM
version 12.14, administrators can enable a setting in user credential profiles that allows users to dismiss certificate enrollment and complete it later. This option is available for the following connection types: Device (App) Based Provider, Entrust Smart Credential, Native Keystore.

WKWebView limitations for
iOS
14

The following WKWebView classes and methods are new in
iOS
14 and are not yet supported by the
BlackBerry Dynamics SDK
:

BlackBerry Dynamics Launcher Library

This release uses
BlackBerry Dynamics Launcher Library
version 3.2.0.296.

Fixed issues

The following issues are fixed in this release:
  • If the compliance grace period was set to 25 days or more in the compliance profile, the compliance behavior did not work as expected. (FIRST-17496)

Known issues or limitations

  • If a
    BlackBerry Dynamics
    app uses
    Kerberos
    authentication and the app tries to access a web page using an IP address, after the user enters their credentials, the web page does not load as expected and the user is prompted for their credentials again in a loop. (GD-54481)
    Workaround
    : When developing
    BlackBerry Dynamics
    apps, do not hard code URLs that use IP addresses. If users can manually enter a URL, instruct users to avoid URLs that use an IP address.
  • If a user activates a
    BlackBerry Dynamics
    app using
    BlackBerry Enterprise Identity
    , the user can use a third-party keyboard to enter organization credentials. (GD-54464)
  • If you use the SDK static framework and your project uses
    Xcode
    12.x, changing the configuration to release and building the project to a simulator results in a linker error: "building for iOS Simulator-arm64 but attempting to link with file built for iOS Simulator-x86_64". (GD-53075)
    Workaround:
    Enable the "Build Active Architecture Only" flag or convert the project to use the SDK dynamic framework.
  • If your project uses
    Xcode
    12.x and you enable CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER in the build settings, building a project with SDK headers results in several "double-quoted include, expected angle-bracketed" warnings. (GD-53017)
    Workaround:
    In the build settings, disable CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER.
  • If your project uses
    Xcode
    11.3.1, building your app will result in an "undef: ___darwin_check_fd_set_overflow" linker error. (GD-52947)
    Workaround:
    Update
    Xcode
    to version 11.7.x.
  • Projects that you generate using the
    Xcode
    template do not include the required
    Certicom
    frameworks (BlackBerryCerticom.xcframework and BlackBerryCerticomSBGSE.xcframework). You need to add the frameworks manually. For instructions, see Prepare an app to use the BlackBerry Dynamics SDK static framework or Configure a new or existing BlackBerry Dynamics app to use the dynamic framework. (GD-52168)
  • The AppKinetics sample app no longer opens .doc or .docx files to WKWebView. You can instead use the SecureStore sample app to demonstrate this functionality. (GD-51719)
  • When building the
    BlackBerry Dynamics SDK for iOS
    sample apps, warnings might display. This will be addressed in a future release. (GD-50104)