Skip Navigation

BlackBerry Dynamics SDK for iOS
version 10.1

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

Changes to the SDK and software requirements
Feature
Description
Changes to support for cookies in WKWebView
WKHTTPCookieStore is now fully supported in this release. If a developer sets or deletes cookies by using WKHTTPCookieStore methods, the changes will also be reflected on the SDK side.
The behavior of nonPersistentDataStore is now the same as system behavior. If a developer creates a WKWebView class with a nonPersistentDataStore configuration, the SDK will keep cookies only while the application is running. After restarting the application, cookies will be deleted for the nonPersistentDataStore configuration. If a developer wants cookies to persist after restarting the app, they should use the defaultDataStore configuration for WKWebView.
Changes to support for WKWebView cache
Use of the cache is now enabled in this release of
BlackBerry Dynamics SDK for iOS
. The SDK uses the cache to search for valid cached data for resources loaded by WKWebView.
SwiftUI sample app
The new SwiftUI sample app pairs with Basic-iOS-Swift to provide examples of
iOS
apps before and after integrating with
BlackBerry Dynamics
SDK. The two samples demonstrate features commonly used in
BlackBerry Dynamics
apps, including secure file storage, secure database, and secure communication (HTTP/S and Socket).
Changes to
Xcode
templates from
BlackBerry Dynamics
frameworks
Support for
Xcode
templates has been removed in this release. Developers should use the following sample apps from
GitHub
to integrate the
BlackBerry Dynamics
library using
CocoaPods
:
JavaScript
limitation
If a web page uses any
JavaScript
WebSQL databases,
JavaScript
IndexedDB databases, or HTML local storage features, then they will be available for
JavaScript
while the app is running. When the app is restarted, these storages will be cleared and the
JavaScript
on the page will not find any previously set data.
New administrative and security features
Feature
Description
Support for additional
BlackBerry Protect Mobile
features
This release includes support for new
BlackBerry Protect Mobile
features to detect insecure networks. An administrator enables this features using a
BlackBerry Protect
profile. For more information, see Protecting devices from network threats in the BlackBerry UEM Overview and Administration guide.

BlackBerry Dynamics Launcher Library

This release uses
BlackBerry Dynamics Launcher Library
version 3.3.1.304.

Fixed issues

The following issues are fixed in this release:
  • An issue with caching criteria, which resulted in the wrong
    Kerberos
    ticket being sent in some cases, has been resolved. (FIRST-17590)

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.
  • When an Apple M1 device user tries to remove a BlackBerry Dynamics app binary by moving it to the trash, the secure container is not removed from the device. (GD-53650)
    Workaround:
    The user must delete the folder under ~/Library/Containers/BB_App_Name.
  • 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)
  • If a user upgrades a
    BlackBerry Dynamics
    app that uses SDK version 9.x or earlier to a new version that uses SDK 10.1 or later, the app will not retain any cookies. (GD-55766)