Skip Navigation

BlackBerry Dynamics Bindings for Xamarin.iOS
 7.0

What's new in 
BlackBerry Dynamics Bindings for Xamarin.iOS
 7.0

This release includes updates from the 
BlackBerry Dynamics SDK for iOS
 version 7.0. For more information, see the BlackBerry Dynamics SDK for iOS Release Notes.
Feature
Description
Changes to software requirements
  • Xamarin.iOS
     13.14.1.39 or later (previously 12.14.0.110)
  • Microsoft Visual Studio
     for 
    macOS
     8.5 or later (previously 8.1)
  • macOS
     10.13 or later (previously 10.12)
  • Deployment target 
    iOS
     12 or later (previously 
    iOS
     11)
  • iOS
     SDK 12.0 or later
  • Xcode
     10 or later (previously 9 or later, support for 
    Xcode
     10 will be deprecated in the next major release); Launcher samples require 
    Xcode
     10.2 or later
Updates to sample apps
The RSSReader, GreetingsClient, GreetingsServer sample apps have been updated to support full screen scaling on 
iPhone
 X devices.
Automated testing guidance
The Development Guide provides new guidance for automated testing for BlackBerry Dynamics Xamarin apps. 
New method to retrieve 
Xamarin
 version 
This release includes the GetXamarinVersion method to retrieve the current Xamarin version.
Support for Dark Mode
This release of the SDK adds support for Dark Mode. The Greetings client sample app has been updated to demonstrate how to support this feature.
BlackBerry Dynamics
 shared user identifier
This release of the SDK adds a new 
BlackBerry Dynamics
 shared user identifier that uniquely identifies a container on a user's device. The identifier is intended for use by 
BlackBerry
 services. For more information, see the 
BlackBerry Dynamics
 Shared User Identifier section in the GDUtility class reference.
Required SDK changes
Feature
Description
Support for 
macOS
 10.15 (Catalina)
macOS
 10.15 currently treats the 
BlackBerry Dynamics Bindings for Xamarin.iOS
 as untrusted software. For  more information, see the known issues section below.
New framework dependency
The 
BlackBerry Dynamics Bindings for Xamarin.iOS
 version 7.0 requires 
SafariServices.framework
 in the Link Binary With Libraries build phase to compile apps. For a complete list of the required frameworks and libraries, see the Software requirements.
Deprecating UIWebView in an upcoming release
In an upcoming release, support for UIWebView will be removed from the 
BlackBerry Dynamics SDK
. UIWebView was deprecated by 
Apple
 in 
iOS
 12.0. It is recommended to use WKWebView in 
BlackBerry Dynamics
 apps instead.
New administrative and security features
Feature
Description
Support PAC files for connections to application servers
UEM
 version 12.12 adds support for using proxy auto-config (PAC) files for 
BlackBerry Dynamics
 app connections to application servers. The administrator configures global PAC file support in Settings > Infrastructure > BlackBerry Router and proxy > Global settings > BlackBerry Dynamics proxy settings. The administrator can configure PAC file support at the cluster level in Settings > 
BlackBerry Dynamics
 > Clusters (select Override global settings > Enable PAC).
This feature is applicable only to 
BlackBerry Dynamics
 apps with SDK version 7.0 or later.
If the PAC file is applied through the 
BlackBerry Proxy
 configuration, the administrator must configure a 
BlackBerry Dynamics
 connectivity profile to direct connections to the 
BlackBerry Proxy
.
For more information about this feature, including limitations and conditions, see the UEM Configuration content ("Sending 
BlackBerry Dynamics
 app data through an HTTP proxy").
Note the following:
  • Only HTTPS proxy is supported in PAC files.
  • This feature does not support proxy servers that use Kerberos.
  • This feature does not support user-provided authentication credentials.
  • If a custom 
    BlackBerry Dynamics
     app implements its own method of proxy support, you can use WebProxyAppliedByApp to override the PAC support configured in 
    UEM
     (typically this is not required).
Changes to 
BlackBerry Dynamics
 communication settings
In new installations of 
UEM
 version 12.12 and later, all 
BlackBerry Dynamics Runtime
 connections to application servers now use TLS 1.2 by default. If you upgrade to 
UEM
 version 12.12, the existing communication settings are not changed.
You can change the permitted TLS connections to application servers in the 
UEM
 management console (Settings > 
BlackBerry Dynamics
).
Note that SSL version 3 or older is no longer supported.
Advanced security features with 
CylancePROTECT
This version of the 
BlackBerry Dynamics SDK
 integrates the 
CylancePROTECT
 library to support CylancePROTECT in BlackBerry UEM
CylancePROTECT
 is a licensed service that offers a suite of features that enhances 
BlackBerry UEM
’s ability to detect, prevent, and resolve security threats without disrupting the productivity of your workforce.
CylancePROTECT
 uses a combination of advanced technologies, including:
  • The cloud-based 
    CylanceINFINITY
     service that uses AI and machine learning to identify malware and unsafe URL
  • The 
    UEM
     server that provides a complete device management and compliance infrastructure for your organization
  • BlackBerry
     apps that monitor and enforce security standards at the device and user level
The seamless integration of these technologies establishes a secure ecosystem where data is protected and malicious activities are identified at all endpoints and eliminated proactively.
CylancePROTECT
 includes the following features:
  • Malware detection for apps (including 
    BlackBerry Dynamics
     apps) that are uploaded to 
    UEM
     for internal deployment
  • Malware detection on 
    Android
     devices
  • Sideloaded app detection on 
    iOS
     devices (requires the 
    UEM Client
     or 
    BlackBerry Work
    )
  • Safe browsing with 
    BlackBerry Dynamics
     apps
  • Integrity checking for 
    BlackBerry Dynamics
     apps on 
    iOS
     devices using the 
    Apple
     DeviceCheck framework
  • Hardware certificate attestation for 
    BlackBerry Dynamics
     apps on 
    Android
     devices
For more information about 
CylancePROTECT
, see the CylancePROTECT documentation.
Changes to compliance enforcement settings for 
BlackBerry Dynamics
 apps
In 
UEM
 version 12.12, when an administrator creates a new compliance profile to define compliance enforcement actions for 
BlackBerry Dynamics
 apps, the default action is now "Monitor and log".
BlackBerry Dynamics
 app user can upload logs when locked out or blocked
If a user is locked out of a 
BlackBerry Dynamics
 app, or if the user's access to the app is blocked, the user now has an option on the lock or block screen to upload the log file. The log can help the 
UEM
 administrator troubleshoot if the user was locked out or blocked unexpectedly.

BlackBerry Dynamics Launcher Library

This release uses 
BlackBerry Dynamics Launcher Library
 version 3.0.0.249.

Fixed issues

The following issues are fixed in this release:
  • When using a 
    BlackBerry Dynamics
     app on 
    iOS
     13, NSURLSessionDownloadTask and NSURLSessionDataTask did not support authentication (NTLM, Kerberos, or client certificate) as expected. (GD-45134)

Known issues and limitations

  • When building a 
    BlackBerry Dynamics
     Xamarin app in 
    Visual Studio
    , the following warning might display: "App 
    <name>
     cannot be opened because the developer cannot be verified." Native linking errors occur in the build log. This occurs when Catalina 10.15 considers the unpackaged SDK artifacts as untrusted.
    Workaround
    :
    1. Unzip the SDK package.
    2. Run the terminal and change the directory to the location of the unzipped package.
    3. Run the following command: 
      xattr -dr com.apple.quarantine ./
  • When building a 
    BlackBerry Dynamics
     Xamarin app for an 
    iOS
     simulator in 
    Visual Studio
    , MT5209 native linking errors might occur.
    Workaround
    : In the 
    iOS
     build options, turn off "Enable device-specific builds".
  • The Development Guide includes new information about running automated tests for 
    Xamarin
     apps. Note the following limitations:
    • Currently, simple authentication is not supported for the automated tests.
    • For the automated tests you must use a test device or simulator that does not already have a 
      BlackBerry Dynamics
       app installed and provisioned. Enterprise Simulation mode does not have this restriction.
    • There is currently a known issue with 
      iOS
       simulators where automated tests can fail because the keyboard occasionally disappears.