BlackBerry Dynamics SDK for iOS Instructions

Dynamics SDK for iOS

“`html

Specifications:

• Product: BlackBerry Dynamics SDK for iOS
• Version: 13.0
• Release Date: 2024-09-16Z

Product Information:

The BlackBerry Dynamics SDK for iOS version 13.0 brings several
enhancements and fixes to improve the user experience. It includes
integration of the BlackBerry Dynamics Launcher with the SDK, along
with various bug fixes related to iOS 17 devices.

Installation Instructions:

1. Download the BlackBerry Dynamics SDK for iOS version 13.0 from
   the official website.

2. Follow the installation instructions provided in the
   documentation.

3. Ensure that your development environment meets the software
   requirements specified for the SDK.

Usage Instructions:

Integration of BlackBerry Dynamics Launcher:

To integrate the BlackBerry Dynamics Launcher with the SDK:

1. Refer to the documentation on implementing the BlackBerry
   Dynamics Launcher.

2. Follow the steps outlined in the Dynamics SDK Development
   Guide.

Recommendation for Apple Face ID Shortcut:

It is recommended not to enable the Apple Require Face ID
shortcut to prevent interference with how BlackBerry Dynamics apps
utilize Face ID for user authentication during app launch.

Fixed Issues:

The BlackBerry Dynamics SDK version 13.0 addresses several
issues on iOS 17 devices, including problems related to dictation,
image pasting, screen recording, autofill, email address input,
password autofill, app responsiveness, and data leakage prevention
policy.

FAQ:

Q: Can I still use Face ID with BlackBerry Dynamics apps?

A: Yes, Face ID can still be used for authentication in
BlackBerry Dynamics apps. Ensure that the Apple Require Face ID
shortcut is not enabled to avoid any conflicts.

Q: How do I resolve issues with autofill in BlackBerry Dynamics

UI?

A: If you encounter issues with autofill displaying placeholder
text or inserting data incorrectly, consider updating to the latest
version of the SDK or checking for any specific settings related to
autofill in your app.

“`

BlackBerry Dynamics SDK for iOS
Release Notes
13.0

2024-09-16Z | |2

Contents
BlackBerry Dynamics SDK for iOS version 13.0………………………………………….4 Installing or upgrading the software……………………………………………………….. 6 Reference for all deprecated interfaces, classes, and methods……………………. 7 Legal notice………………………………………………………………………………………… 8
| | iii

BlackBerry Dynamics SDK for iOS version 13.0

What’s new in the BlackBerry Dynamics SDK for iOS version 13.0

Changes to the SDK and software requirements:

Feature

Description

Integration of the BlackBerry Dynamics Launcher with the SDK
SDK changes related to the integration of the BlackBerry Dynamics Launcher
Recommendation for Apple Face ID shortcut

In this release, the BlackBerry Dynamics Launcher has been implemented into the BlackBerry Dynamics SDK for iOS. Previously, the Launcher required the integration of a separate BlackBerry Dynamics Launcher Library.
For more information about the integration of the Launcher into the SDK, see Implementing the BlackBerry Dynamics Launcher. The documentation for Launcher integration has now been incorporated into the Dynamics SDK Development Guide.
· The following methods have been deprecated in GTLauncherViewController:
· setGDPushConnectionStatus · startServicesWithOptions · The version method has been renamed to launcherVersion · The following methods have been added (previously they were in the GTLauncherGoodApplication.h header):
· setSectionEnabled · isSectionEnabled · GDiOS has a new method, getManagedLauncherViewController, to return the Launcher instance if it is managed by the BlackBerry Dynamics SDK.
BlackBerry recommends that you do not enable the Apple “Require Face ID” shortcut, because it can interfere with how BlackBerry Dynamics apps use Face ID to authenticate a user when launching the app.

Fixed issues

On devices running iOS 17, the dictation icon was not being removed from BlackBerry Work email fields (To, CC, BCC, and Subject) while the BlackBerry Dynamics dictation policy was turned on. (GD-62423)
On devices running iOS 17, if a user attempted to paste an image or GIF into a text field of a BlackBerry Dynamics app, the app would force shutdown. (GD-62422)
On devices running iOS 17, if a user was screen recording, the device might have failed to recognize a change in screen orientation on BlackBerry Dynamics apps. (GD-62310)
Autofill was available in the BlackBerry Dynamics UI and the placeholder text would still display after autofill. (GD-62208)
Users were unable to use the backspace or delete key on the email address text box after they clicked the back button on the Activation screen. (GD-62191)

| BlackBerry Dynamics SDK for iOS version 13.0 | 4

On devices running iOS 17, users were able to insert password into the body of an email by using autofill. (GD-62161)
On devices running iOS 17, in some cases, if a user opened the docs section of the BlackBerry Dynamics Launcher on a BlackBerry Dynamics app, sent the app to the background, and returned it to the foreground, the app may have stopped responding. (GD-62135)
On devices running iOS 17, if a user entered a certificate password and then deleted the characters in the password field, the deleted characters would autofill in the password field when the user attempted to reenter the password. (GD-62133)
On devices running iOS 17, users were able to insert a contact number into the body of an email while the data leakage prevention policy was turned on. (GD-62050)
Known issues
In BlackBerry Access, users are able to take screenshots of videos playing in full screen mode even if the “iOS Screenshots Prevention” policy is enabled. (GD-64099)
On an Apple Watch, users are able to take screenshots of BlackBerry Work even if the “Do not allow screen captures on iOS devices” BlackBerry Dynamics profile setting is enabled. (GD-62706)
On devices running iOS 17, if a user attempts to copy text from a PDF in a WKWebView app, the user will not be able to copy the text as the prompt does not appear. (GD-62254)
When using NSURLSession for NTLM authentication, if the password includes a non-ASCII character (for example, “ä”), the authentication attempt will fail. (GD-61708)
If a user provisions a BlackBerry Dynamics app using biometric authentication (Touch ID or Face ID) while the “Permit fallback to device passcode if biometric authentication fails” policy is enabled, sends the app to the background, returns the app to the foreground, and selects “Don’t Allow” at the Face ID prompt, the user is forced to use the device passcode to unlock the container instead of the container password. The user could not use the container password to unlock the app when it is sent to the background and returned to the foreground again. (GD-59075) Workaround: The user must restart the app to use the container password. To re-enable Face ID authentication to the app, the user must go to Device Settings > Face ID and Passcode > Other Apps and enable Face ID for the app.
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 to enter their credentials again in a loop. (GD-54481) Workaround: When you develop 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.
| BlackBerry Dynamics SDK for iOS version 13.0 | 5

Installing or upgrading the software
For complete installation instructions, upgrade guidance, and software requirements, see the BlackBerry Dynamics SDK for iOS Development Guide. Note: The BlackBerry Dynamics SDK for iOS 5.0 and later includes a compliance enhancement to protect against malicious attempts to add a debugger to deployed BlackBerry Dynamics apps. Your options for configuring this feature depend on the version of BlackBerry UEM and the BlackBerry Dynamics SDK. For more information, see Configure compliance settings so you can debug your app in the BlackBerry Dynamics SDK Development Guide.
| Installing or upgrading the software | 6

Reference for all deprecated interfaces, classes, and methods
This document specifies the interfaces, classes, and methods that were deprecated in this release of the SDK. For a full list of all deprecated objects, view the API reference for your platform and open the deprecated list in the appendix. You should plan to stop using any interfaces, classes, and methods that are included in the deprecated list.
| Reference for all deprecated interfaces, classes, and methods | 7

Legal notice
©2024 BlackBerry Limited. Trademarks, including but not limited to BLACKBERRY, BBM, BES, EMBLEM Design, ATHOC, CYLANCE and SECUSMART are the trademarks or registered trademarks of BlackBerry Limited, its subsidiaries and/or affiliates, used under license, and the exclusive rights to such trademarks are expressly reserved. All other trademarks are the property of their respective owners.
Patents, as applicable, identified at: www.blackberry.com/patents.
This documentation including all documentation incorporated by reference herein such as documentation provided or made available on the BlackBerry website provided or made accessible “AS IS” and “AS AVAILABLE” and without condition, endorsement, guarantee, representation, or warranty of any kind by BlackBerry Limited and its affiliated companies (“BlackBerry”) and BlackBerry assumes no responsibility for any typographical, technical, or other inaccuracies, errors, or omissions in this documentation. In order to protect BlackBerry proprietary and confidential information and/or trade secrets, this documentation may describe some aspects of BlackBerry technology in generalized terms. BlackBerry reserves the right to periodically change information that is contained in this documentation; however, BlackBerry makes no commitment to provide any such changes, updates, enhancements, or other additions to this documentation to you in a timely manner or at all.
This documentation might contain references to third-party sources of information, hardware or software, products or services including components and content such as content protected by copyright and/or thirdparty websites (collectively the “Third Party Products and Services”). BlackBerry does not control, and is not responsible for, any Third Party Products and Services including, without limitation the content, accuracy, copyright compliance, compatibility, performance, trustworthiness, legality, decency, links, or any other aspect of Third Party Products and Services. The inclusion of a reference to Third Party Products and Services in this documentation does not imply endorsement by BlackBerry of the Third Party Products and Services or the third party in any way.
EXCEPT TO THE EXTENT SPECIFICALLY PROHIBITED BY APPLICABLE LAW IN YOUR JURISDICTION, ALL CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS, OR WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR WARRANTIES OF DURABILITY, FITNESS FOR A PARTICULAR PURPOSE OR USE, MERCHANTABILITY, MERCHANTABLE QUALITY, NON-INFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, OR ARISING FROM A STATUTE OR CUSTOM OR A COURSE OF DEALING OR USAGE OF TRADE, OR RELATED TO THE DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN, ARE HEREBY EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT VARY BY STATE OR PROVINCE. SOME JURISDICTIONS MAY NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES AND CONDITIONS. TO THE EXTENT PERMITTED BY LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE DOCUMENTATION TO THE EXTENT THEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, ARE HEREBY LIMITED TO NINETY (90) DAYS FROM THE DATE YOU FIRST ACQUIRED THE DOCUMENTATION OR THE ITEM THAT IS THE SUBJECT OF THE CLAIM.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO EVENT SHALL BLACKBERRY BE LIABLE FOR ANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN INCLUDING WITHOUT LIMITATION ANY OF THE FOLLOWING DAMAGES: DIRECT, CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, INDIRECT, SPECIAL, PUNITIVE, OR AGGRAVATED DAMAGES, DAMAGES FOR LOSS OF PROFITS OR REVENUES, FAILURE TO REALIZE ANY EXPECTED SAVINGS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, LOSS OF BUSINESS OPPORTUNITY, OR CORRUPTION OR LOSS OF DATA, FAILURES TO TRANSMIT OR RECEIVE ANY DATA, PROBLEMS ASSOCIATED WITH ANY APPLICATIONS USED IN CONJUNCTION WITH BLACKBERRY PRODUCTS OR SERVICES, DOWNTIME COSTS, LOSS OF THE USE OF BLACKBERRY PRODUCTS OR SERVICES OR ANY PORTION THEREOF OR OF ANY AIRTIME SERVICES, COST OF SUBSTITUTE GOODS, COSTS OF COVER, FACILITIES OR SERVICES, COST OF CAPITAL, OR OTHER SIMILAR PECUNIARY LOSSES, WHETHER OR NOT SUCH DAMAGES
| Legal notice | 8

WERE FORESEEN OR UNFORESEEN, AND EVEN IF BLACKBERRY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, BLACKBERRY SHALL HAVE NO OTHER OBLIGATION, DUTY, OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OR OTHERWISE TO YOU INCLUDING ANY LIABILITY FOR NEGLIGENCE OR STRICT LIABILITY.
THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF THE NATURE OF THE CAUSE OF ACTION, DEMAND, OR ACTION BY YOU INCLUDING BUT NOT LIMITED TO BREACH OF CONTRACT, NEGLIGENCE, TORT, STRICT LIABILITY OR ANY OTHER LEGAL THEORY AND SHALL SURVIVE A FUNDAMENTAL BREACH OR BREACHES OR THE FAILURE OF THE ESSENTIAL PURPOSE OF THIS AGREEMENT OR OF ANY REMEDY CONTAINED HEREIN; AND (B) TO BLACKBERRY AND ITS AFFILIATED COMPANIES, THEIR SUCCESSORS, ASSIGNS, AGENTS, SUPPLIERS (INCLUDING AIRTIME SERVICE PROVIDERS), AUTHORIZED BLACKBERRY DISTRIBUTORS (ALSO INCLUDING AIRTIME SERVICE PROVIDERS) AND THEIR RESPECTIVE DIRECTORS, EMPLOYEES, AND INDEPENDENT CONTRACTORS.
IN ADDITION TO THE LIMITATIONS AND EXCLUSIONS SET OUT ABOVE, IN NO EVENT SHALL ANY DIRECTOR, EMPLOYEE, AGENT, DISTRIBUTOR, SUPPLIER, INDEPENDENT CONTRACTOR OF BLACKBERRY OR ANY AFFILIATES OF BLACKBERRY HAVE ANY LIABILITY ARISING FROM OR RELATED TO THE DOCUMENTATION.
Prior to subscribing for, installing, or using any Third Party Products and Services, it is your responsibility to ensure that your airtime service provider has agreed to support all of their features. Some airtime service providers might not offer Internet browsing functionality with a subscription to the BlackBerry® Internet Service. Check with your service provider for availability, roaming arrangements, service plans and features. Installation or use of Third Party Products and Services with BlackBerry’s products and services may require one or more patent, trademark, copyright, or other licenses in order to avoid infringement or violation of third party rights. You are solely responsible for determining whether to use Third Party Products and Services and if any third party licenses are required to do so. If required you are responsible for acquiring them. You should not install or use Third Party Products and Services until all necessary licenses have been acquired. Any Third Party Products and Services that are provided with BlackBerry’s products and services are provided as a convenience to you and are provided “AS IS” with no express or implied conditions, endorsements, guarantees, representations, or warranties of any kind by BlackBerry and BlackBerry assumes no liability whatsoever, in relation thereto. Your use of Third Party Products and Services shall be governed by and subject to you agreeing to the terms of separate licenses and other agreements applicable thereto with third parties, except to the extent expressly covered by a license or other agreement with BlackBerry.
The terms of use of any BlackBerry product or service are set out in a separate license or other agreement with BlackBerry applicable thereto. NOTHING IN THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY EXPRESS WRITTEN AGREEMENTS OR WARRANTIES PROVIDED BY BLACKBERRY FOR PORTIONS OF ANY BLACKBERRY PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION.
BlackBerry Enterprise Software incorporates certain third-party software. The license and copyright information associated with this software is available at http://worldwide.blackberry.com/legal/thirdpartysoftware.jsp.
BlackBerry Limited 2200 University Avenue East Waterloo, Ontario Canada N2K 0A7
BlackBerry UK Limited Ground Floor, The Pearce Building, West Street, Maidenhead, Berkshire SL6 1RL United Kingdom
Published in Canada
| Legal notice | 9

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>