Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Dynamics SDK for React Native 13.0
  3. BlackBerry Dynamics SDK for React Native Release Notes
  4. BlackBerry Dynamics SDK for React Native version 13.0

BlackBerry Dynamics SDK for React Native
 version 13.0

The
BlackBerry Dynamics SDK for React Native
 can be downloaded from BlackBerry Developer Downloads. Development guidance is contained in the README file of the download package.
New in this release
Feature
Description
Changes to supported
React Native
 versions
This release adds support for
React Native
 0.75.x.
The following
React Native
 versions are deprecated and will be removed in an upcoming release:
  • 0.73.x
  • 0.72.x
  • 0.71.x
This release removes support for
React Native
 0.70.x.
Integration of the
BlackBerry Dynamics Launcher
The
BlackBerry Dynamics Launcher
 is now integrated with the
BlackBerry Dynamics SDK for React Native
 and does not need to be integrated separately. When you add the BlackBerry-Dynamics-for-React-Native-Base module, the
BlackBerry Dynamics Launcher
 is integrated automatically and shown in apps by default.
Previously, the BlackBerry-Dynamics-for-React-Native-Launcher module was used to integrate the
BlackBerry Dynamics Launcher
. It is now used to programmatically hide or show the
BlackBerry Dynamics Launcher
. See the Features section below for instructions on how to hide or show the
BlackBerry Dynamics Launcher
. As of this release, the BlackBerry-Dynamics-for-React-Native-Launcher module should be used only with
BlackBerry Dynamics SDK for Android
 13.0 or later and the
BlackBerry Dynamics SDK for iOS
 13.0 or later.
Support
Feature
Description
Development requirements
  • Windows 11
     (
    Android
     only)
  • Windows 10
     (
    Android
     only)
  • macOS
     X
React Native
 supported versions
  • 0.75.x
  • 0.74.x
The following
React Native
 versions are deprecated and support will be removed in an upcoming release:
  • 0.73.x
  • 0.72.x
  • 0.71.x
React Native
 version 0.73.x and later requires
Java
 17.
BlackBerry Dynamics SDK
 supported versions
Features
Feature
Description
Integration with
BlackBerry Dynamics
Integration of the
BlackBerry Dynamics SDK
 for
iOS
 and
Android
 into the
React Native
 application is supported by the addition of the BlackBerry-Dynamics-for-React-Native-Base module. You can also integrate a locally downloaded version of
BlackBerry Dynamics SDK for iOS
 into your
BlackBerry Dynamics
React Native
 app.
Secure connectivity
  • XMLHttpRequest and fetch are secured in scope of the BlackBerry-Dynamics-for-React-Native-Networking module.
  • <WebView /> is secured in scope of the BlackBerry-Dynamics-for-React-Native-WebView UI component.
Secure storage
  • AsyncStorage is secured in the BlackBerry-Dynamics-for-React-Native-Async-Storage module.
  • SQLite is secured in the BlackBerry-Dynamics-for-React-Native-SQLite-Storage module.
Data leakage prevention (DLP)
No code work is required to support DLP for
iOS
 and
Android
. Note the following:
  • On
    iOS
    , the <Text /> component, <TextInput /> component, and Clipboard API are secured by integrating
    BlackBerry Dynamics
    .
  • On
    Android
    , the following items are required:
    • The <Text /> component is secured in scope of the BlackBerry-Dynamics-for-React-Native-Text UI component.
    • The <TextInput /> component is secured in scope of the BlackBerry-Dynamics-for-React-Native-TextInput UI component.
    • The BlackBerry-Dynamics-for-React-Native-Clipboard module secures the Clipboard API on Android.
Inter-Container Communication (ICC)
ICC (also known as AppKinetics) provides service discovery, service consumption, and service providing capabilities for
BlackBerry Dynamics
React Native
 apps and allows secure communication with other
BlackBerry Dynamics
 apps. To implement some ICC capabilities in
BlackBerry Dynamics
React Native
 apps, use the BlackBerry-Dynamics-for-React-Native-AppKinetics module.
Support for Yarn package manager
  • To add a
    BlackBerry Dynamics
    React Native
     module, run following command:
    $ yarn add
    <path_to_module>
  • To remove a
    BlackBerry Dynamics
    React Native
     module, run following command:
    $ yarn remove
    <path_to_module>
For more information, see the readme file for each module.
Importing a prepopulated SQLite database
You can use any of the methods detailed here to import a prepopulated SQLite database: Importing a prepopulated database. The third method is supported for
Android
 only.
Integration of the
BlackBerry Dynamics Launcher
As of SDK version 13.0, the
BlackBerry Dynamics Launcher
 is integrated automatically with the
BlackBerry Dynamics SDK for React Native
 and does not need to be integrated separately. When you add the BlackBerry-Dynamics-for-React-Native-Base module, the
BlackBerry Dynamics Launcher
 is integrated automatically and shown in apps by default.
You can use the BlackBerry-Dynamics-for-React-Native-Launcher module to hide or show the
BlackBerry Dynamics Launcher
:
  • For
    iOS
    , add the following property in
    <app>
    /ios/
    <app-name>
    /Info.plist:
    • Hide the Launcher:
      GDDisableAutomaticLauncherManagement = YES
    • Show the Launcher:
      GDDisableAutomaticLauncherManagement = NO
  • For
    Android
    , add the following property in <app>/android/app/src/main/assets/com.blackberry.dynamics.settings.json:
    • Hide the Launcher:
      "AutomaticLauncherManagement": "false"
    • Show the Launcher:
      "AutomaticLauncherManagement": "true"
As of the
BlackBerry Dynamics SDK for React Native
 13.0, the BlackBerry-Dynamics-for-React-Native-Launcher module should be used only with
BlackBerry Dynamics SDK for Android
 13.0 or later and the
BlackBerry Dynamics SDK for iOS
 13.0 or later.
Package contents
Feature
Description
Modules
  • BlackBerry-Dynamics-for-React-Native-Base automatically integrates the
    BlackBerry Dynamics SDK
     for
    iOS
     and
    Android
     into the React Native application.
  • BlackBerry-Dynamics-for-React-Native-Networking secures XMLHttpRequest and fetch APIs on
    Android
    . For more information, see React Native: Networking.
  • BlackBerry-Dynamics-for-React-Native-SQLite-Storage secures SQLite database usage, based on the react-native-sqlite-storage third-party module.
  • BlackBerry-Dynamics-for-React-Native-Async-Storage secures built-in AsyncStorage.
  • BlackBerry-Dynamics-for-React-Native-Clipboard secures the built-in Clipboard API.
  • BlackBerry-Dynamics-for-React-Native-AppKinetics provides the ability to use
    BlackBerry Dynamics
     app-based services within a
    BlackBerry Dynamics
     React Native app to securely communicate with other
    BlackBerry Dynamics
     apps in a process called Inter-Container Communication (ICC) or AppKinetics; also provides service discovery, service consumption, and service providing capabilities.
  • BlackBerry-Dynamics-for-React-Native-FileSystem secures the API for the react-native-fs module; the JavaScript API of this module is the same, but files and directories are now stored and managed within the
    BlackBerry Dynamics
     secure container.
  • BlackBerry-Dynamics-for-React-Native-Launcher allows you to programmatically hide or show the
    BlackBerry Dynamics Launcher
     in your
    BlackBerry Dynamics
    React Native
     apps. The
    BlackBerry Dynamics Launcher
     is integrated automatically and displayed by default when you add the BlackBerry-Dynamics-for-React-Native-Base module.
  • BlackBerry-Dynamics-for-React-Native-Application allows you to access information that is globally available to any
    BlackBerry Dynamics
     app.
  • BlackBerry-Dynamics-for-React-Native-Camera secures the API for react-native-vision-camera. The JavaScript API of this React Native module is the same, but captured media files (photos, recorded videos) are now stored in the
    BlackBerry Dynamics
     secure container.
UI components
  • BlackBerry-Dynamics-for-React-Native-Text enables data leakage protection (DLP) within UI components on
    Android
    .
  • BlackBerry-Dynamics-for-React-Native-TextInput enables DLP within UI components on
    Android
    .
  • BlackBerry-Dynamics-for-React-Native-WebView secures the built-in <WebView /> UI component to securely load public and enterprise resources within a WebView.
Sample apps
  • BasicNetworking provides examples of using fetch and XMLHttpRequest in different scenarios. This app covers different HTTP request types (GET, POST, PUT, DELETE, and so on), authentication types (basic auth, Digest, NTLM), and includes the ability to send different data types to the server and receive responses for different data types.
  • ClipboardTestApp demonstrates how to use the Clipboard API for data leakage prevention (DLP). It is possible to change the DLP policy on
    UEM
     and see how it affects the clipboard within the app. If DLP is enabled, clipboard data cannot be copied from a
    BlackBerry Dynamics
     app to a non-
    BlackBerry Dynamics
     app, and vice-versa.
  • DLP demonstrates how to use the <Text /> and <TextInput /> UI components together with the
    UEM
     DLP policy option. If DLP is on, it is not possible to perform cut-copy-paste operations to transfer data from
    BlackBerry Dynamics
     to non-
    BlackBerry Dynamics
     applications, and vice-versa.
  • SQLite demonstrates how to use a secure SQLite DB instance in a React Native app.
  • UnitTest runs Jasmine unit tests for fetch, XMLHttpRequest, Clipboard, AsyncStorage, SQLite, and AppKinetics in a React Native application.
  • WebViewBrowser demonstrates how to use the <WebView /> component in a
    React Native
     application.
  • FileSystem demonstrates how to use a secure FileSystem instance in a
    React Native
     app, how to manage files and directories, and how to upload and download files.
  • WebSocketClient and WebSocketServer demonstrate how to establish a connection to a WebSocket server using "ws://" or "wss://" protocols, how to send or receive text or binary data over a WebSocket connection, and how to close a WebSocket connection.
  • AppKinetics demonstrates how to use AppKinetics, or secure Inter-Container Communication (ICC), including sending and receiving files using ICC and creating secure email with
    BlackBerry Work
     or the native email client (if permitted).
  • Policy demonstrates how to retrieve a collection of app-specific configuration and policy settings. The retrieval of these settings happens during the method call or whenever settings are changed.
  • Camera demonstrates the use of the BlackBerry-Dynamics-for-React-Native-Camera module to store photos and recorded videos in the
    BlackBerry Dynamics
     secure container, and demonstrates how to send media files to other
    BlackBerry Dynamics
     apps using Inter-Container Communication.

Fixed issues

If you tried to build an application using the BlackBerry-Dynamics-for-React-Native-Networking module, the application might not have been built successfully due to the following error: “Failed to fetch podspec for ‘BbdJetfire’”. (GD-67576)
If you built an application on React Native 71.x, then you removed the base module (BlackBerry-Dynamics-for-React-Native-Base module), you could not rebuild the application. (GD-67347)
If you built an application using the BlackBerry-Dynamics-for-React-Native-Launcher module, then added another module and tried to build again, the app did not build successfully. (GD-66173)
In the WebViewBrowser sample app, images that you tried to upload from
Google Drive
 did not upload successfully. (GD-55256)

Known issues

Image content may not be visible on the
iOS
 clipboard sample app. (GD-63121)
Flipper cannot be used with the
BlackBerry Dynamics SDK for React Native
 in the debug configuration because it disables some
BlackBerry Dynamics
 secure networking functionality. Flipper is disabled by default on
iOS
 and
Android
. If your
BlackBerry Dynamics SDK for React Native
 app does not use the secure connectivity feature (BlackBerry-Dynamics-for-React-Native-Networking module), you can enable Flipper by uncommenting the following:
  • On
    iOS
    : Uncomment the
    use_flipper!()
     line in Podfile.
  • On
    Android
    : Uncomment the
    initializeFlipper(this, getReactNativeHost().getReactInstanceManager());
     line in MainApplication.java for
    React Native
     versions less than 71, or uncomment the
    ReactNativeFlipper.initializeFlipper(this, getReactNativeHost().getReactInstanceManager());
     line in MainApplication.java for React Native versions 71 and later.
When both default and secure SQLite libraries are linked to an
iOS
 project, it can cause conflicts and unpredictable behavior.
Workaround:
 Remove the
sqlite3
 dependency in */node_modules/reactnative- webrtc/react-native-webrtc.podspec, and then run
pod install
 again.
Apps targeting
Android
 12 and higher are required to specify an explicit value for
android:exported
 when the corresponding component has an intent filter defined. More details can be found here.
React Native
 0.68 and higher supports
Android
 12 and later by default by setting the appropriate configuration in AndroidManifest.xml.
React Native
 for
iOS
 projects using
Xcode
 14.3 (14E222b) fail to build properly. This is a known issue with the
React Native
 platform. Additional details can be found here.
When loading the Metro server on
React Native
 versions 0.72.0 or 0.72.1, a "Cannot read properties of undefined (reading 'addHelper')" error occurs.
Workaround:
 Add the following devDependency to the project: 
$ yarn add @babel/traverse@7.22.8 --dev
When creating a new
React Native
 project on versions 0.72.5 or earlier, an error may occur when installing activesupport CocoaPods dependencies.
Workaround:
 Create or update the gemfile in the root of your project with this dependency:
gem 'activesupport', '~> 7.0.8'
. Then run the following commands: 
$ bundle update activesupport
$ bundle exec pod install
The same issue can occur when running
BlackBerry Dynamics
React Native
 sample apps. Verify that version 7.0.8 of activesupport Ruby gem is installed locally: 
gem uninstall activesupport --version 7.x.x
gem install activesupport --version 7.0.8