Skip to content

Latest commit

 

History

History
161 lines (139 loc) · 7.27 KB

README.md

File metadata and controls

161 lines (139 loc) · 7.27 KB
Raw

UnitTests sample application

UnitTests sample application runs Jasmine unit tests for fetch, XMLHttpRequest, Clipboard, AsyncStorage, SQLite and AppKinetics, FileSystem, Launcher, Application in React Native application.

How to prepare the app

Open the sample app directory in Terminal window: $ cd <path>/SampleApplications/UnitTests

Install dependencies: $ yarn

NOTE: UnitTests sample is based on 0.70.0 version of React Native. There is a possibility to upgrade to 0.70.x, 0.71.x, 0.72.x versions (0.70.1 - 0.70.10, 0.71.0 - 0.71.13, 0.72.0 - 0.72.4) by running one of following commands: $ npx react-native upgrade 0.70.x for example: $ npx react-native upgrade 0.70.10 or $ npx react-native upgrade 0.71.13 or $ npx react-native upgrade 0.72.4

Generate ios and android directories: $ npx react-native eject

There is a known issue with loading Metro server on 0.72.0 and 0.72.1 versions when the error message is displayed during app load in Metro server: "Cannot read properties of undefined (reading 'addHelper')". The issue can be fixed by adding the following devDependency to the project: $ yarn add @babel/traverse@7.22.8 --dev

Dynamics modules

Prerequisites

There are some dependencies that need to be installed before using BlackBerry-Dynamics-for-React-Native-Base module. More information can be found here.

How to integrate Dynamics into application

$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Base

Integrates Dynamics based on your current identifiers - iOS Bundle ID and Android Package Name.

$ yarn set-bundle-id (Optional step, but required for sample applications)

Allows to update an identifier (required) and name (optional) for your application. This identifier is your iOS Bundle ID or Android Package Name. It will also be used as the Entitlement ID for entitling and activating your application with the BlackBerry UEM management console.

How to secure communication

$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Networking

How to secure AsyncStorage

$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Async-Storage

How to secure SQLite Storage

$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-SQLite-Storage

How to secure Clipboard API

$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Clipboard

How to secure AppKinetics

$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-AppKinetics

How to secure FileSystem

$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-FileSystem

How to add Launcher module

$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Launcher

How to add Application module

$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Application
iOS

Different ruby versions might be install on the machine. Especially it is related to React Native v0.70.x projects. Depending on your Mac configuration following error can occur when running pod install command:

Traceback (most recent call last):
	4: from /Users/vtaliar/.rvm/gems/ruby-2.7.5/bin/ruby_executable_hooks:22:in `<main>'
	3: from /Users/vtaliar/.rvm/gems/ruby-2.7.5/bin/ruby_executable_hooks:22:in `eval'
	2: from /Users/vtaliar/.rvm/gems/ruby-2.7.5/bin/pod:23:in `<main>'
	1: from /Users/vtaliar/.rvm/rubies/ruby-2.7.5/lib/ruby/2.7.0/rubygems.rb:296:in `activate_bin_path'
/Users/vtaliar/.rvm/rubies/ruby-2.7.5/lib/ruby/2.7.0/rubygems.rb:277:in `find_spec_for_exe': can't find gem cocoapods (>= 0.a) with executable pod (Gem::GemNotFoundException)

More details can be found here.

$ bundle install - needed on some 0.70.x versions to fix the issue above
$ cd ios
$ pod install
$ cd .. $ yarn integrate-launcher

How to run application

iOS

$ npx react-native run-ios

Android

$ npx react-native run-android

Examples of usage

0.70.0

$ cd <path>/SampleApplications/UnitTests
$ yarn
$ git init
$ npx react-native eject
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Base
$ yarn set-bundle-id
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Networking
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Async-Storage
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-SQLite-Storage
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Clipboard
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-AppKinetics
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-FileSystem
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Launcher
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Application
For iOS:
$ bundle install
$ cd ios
$ pod install
$ cd ..
$ yarn integrate-launcher
$ npx react-native run-ios
For Android:
$ npx react-native run-android

0.70.10

$ cd <path>/SampleApplications/UnitTests
$ yarn
$ git init
$ npx react-native upgrade 0.70.10
$ npx react-native eject
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Base
$ yarn set-bundle-id
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Networking
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Async-Storage
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-SQLite-Storage
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Clipboard
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-AppKinetics
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-FileSystem
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Launcher
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Application
For iOS:
$ cd ios
$ pod install
$ cd ..
$ yarn integrate-launcher
$ npx react-native run-ios
For Android:
$ npx react-native run-android

0.72.0

$ cd <path>/SampleApplications/UnitTests
$ yarn
$ yarn add @babel/traverse@7.22.8 --dev - OPTIONAL: needed on 0.72.0, 0.72.1 versions to fix the error mentioned above in Metro server
$ git init
$ npx react-native upgrade 0.72.0
$ npx react-native eject
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Base
$ yarn set-bundle-id
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Networking
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Async-Storage
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-SQLite-Storage
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Clipboard
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-AppKinetics
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-FileSystem
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Launcher
$ yarn add <path>/modules/BlackBerry-Dynamics-for-React-Native-Application
For iOS:
$ cd ios
$ pod install
$ cd ..
$ yarn integrate-launcher
$ npx react-native run-ios
For Android:
$ npx react-native run-android