Oracle Banking Digital Experience - Oracle Help Center Oracle Banking Digital Experience Mobile...

Oracle Banking Digital

Experience Mobile Application Builder – iOS

Release 17.2.0.0.0

Part No. E88573-01

July 2017

ii

Oracle Banking Digital Experience Mobile Application Builder – iOS ii

Mobile Application Builder – iOS

July 2017

Oracle Financial Services Software Limited

Oracle Park

Off Western Express Highway

Goregaon (East)

Mumbai, Maharashtra 400 063

India

Worldwide Inquiries:

Phone: +91 22 6718 3000

Fax:+91 22 6718 3001 www.oracle.com/financialservices/

Copyright © 2017, Oracle and/or its affiliates. All rights reserved.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are “commercial computer software” pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate failsafe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

This software or hardware and documentation may provide access to or information on content, products and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

http://www.oracle.com/financialservices/

iii

Oracle Banking Digital Experience Mobile Application Builder – iOS iii

Table of Contents

1. Preface ................................................................................................................................................. 4

1.1 Intended Audience ........................................................................................................................ 4

1.2 Documentation Accessibility ......................................................................................................... 4

1.3 Access to Oracle Support ............................................................................................................. 4

1.4 Structure ........................................................................................................................................ 4

1.5 Related Information Sources......................................................................................................... 4

2. Install node Js ..................................................................................................................................... 5

3. Create project ..................................................................................................................................... 6

4. Archive and Export : ........................................................................................................................ 20

5. OBDX Authenticator Application .................................................................................................... 22

5.1 Building Authenticator UI ............................................................................................................. 22

5.2 Authenticator Application Workspace Setup ............................................................................... 25

5.3 Building Authenticator Application............................................................................................... 29

Preface

4

Oracle Banking Digital Experience Mobile Application Builder – iOS 4

1. Preface

1.1 Intended Audience

This document is intended for the following audience:

Customers

Partners

1.2 Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program

website at http://www.oracle.com/pls/topic/lookup?ctx=accandid=docacc.

1.3 Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit

http://www.oracle.com/pls/topic/lookup?ctx=accandid=info or visit

http://www.oracle.com/pls/topic/lookup?ctx=accandid=trs if you are hearing impaired.

1.4 Structure

This manual is organized into the following categories:

Preface gives information on the intended audience. It also describes the overall structure of the User Manual.

The subsequent chapters describes following details:

Configuration / Installation.

1.5 Related Information Sources

For more information on Oracle Banking Digital Experience Release 17.2.0.0.0, refer to the following documents:

Oracle Banking Digital Experience Licensing Guide

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc

Install node Js

5


2. Install node Js

Install node js from https://nodejs.org.

https://nodejs.org/

Create project

6


3. Create project

Run Following commands on terminal

1. Install cordova using the command

sudo npm install –g cordova

2. Create project using following command

cordova create <directory name> <package name> <project name>

Eg : cordova create zigbank com.ofss.zigbank ZigBank

3. All subsequent commands need to be run within the project's directory

cd <directory name>

Eg: cd zigbank

4. Add platform ios to the project using following command

cordova platform add ios

5. Extract OBDX_Installer.zip and perform the following steps on the extracted folder

a. Copy and Replace OBDX_Installer/installables/mobile/service/ios/Images.xcassets directory from extracted zip into zigbank/platforms/ios/ZigBank

b. Copy cordova_plugins.js from OBDX_Installer/installables/mobile/service/ios/www directory and replace it in zigbank/platforms/ios/www/

c. Copy plugins directory from OBDX_Installer/installables/mobile/service/ios/www directory and paste it in zigbank/platforms/ios/www/

d. Copy and Replace config.xml from OBDX_Installer/installables/mobile/service/ios into zigbank/platforms/ios/ZigBank

6. Open project in xcode by double clicking zigbank/platforms/ios/ZigBank.xcodeproj

Create project

7


7. Delete config.xml and www outside the staging area as shown below Delete -> Move to Trash

8. Delete & Move to trash css, img, js, index.html from staging -> www

Create project

8


9. Using Finder, copy obdxframework.framework from OBDX_Installer/installables/mobile/service/ios/iphonedevice (if you are testing on device - Recommended) else if you are testing it on simulator use OBDX_Installer/installables/mobile/service/ios/iphonesimulator and paste it into zigbank/platforms/ios

10. Go back to xcode, Click on project(ZigBank in Navigator Pane) -> then in the right pane -> select General -> Scroll to Embedded Binaries -> click + -> click on button add other -> navigate to zigbank/platforms/ios and select obdxframework.framework -> click on open button -> check Copy items if needed and select create groups(default) -> finish

Create project

9


11. Go to Build Phases under project -> Link Binary with libraries -> select libcordova.a -> click –

Create project

10


12. In xcode, press cmd+shift+o, type MainViewController.m, press enter, Add following code to viewWillAppear method in MainViewController.m file :

Replace -> [super viewWillAppear:animated]; with following

Create project

11


CGRect screenBounds = [[UIScreen mainScreen] bounds];

screenBounds.origin.y = screenBounds.origin.y + 20;

screenBounds = CGRectMake(screenBounds.origin.x, screenBounds.origin.y,

screenBounds.size.width, screenBounds.size.height-20);

[self.webView setFrame:screenBounds];

self.webView.layer.backgroundColor = (__bridge CGColorRef

_Nullable)([UIColor clearColor]);

[super viewWillAppear:animated];

13. For https urls, get the https certificate of server, rename the certificate as trusted Certificate.cer and proceed as shown in the next step, else skip next step (in case of http server url)

14. Copy trustedCertificate.cer and paste it into zigbank\platforms\ios\ZigBank directory. Right click on Resources -> Add Files to ZigBank

Create project

12


15. In the Popup, select trustedCertificate.cer and click Add

Create project

13


16. Using finder, Copy app.plist from OBDX_Installer/installables/mobile/service/ios and paste it into zigbank\platforms\ios\ZigBank directory. Go back to xcode, in navigation pane, Right click on Resources -> Add Files to ZigBank

Create project

14


17. In the Popup, select navigate to zigbank\platforms\ios\ZigBank directory and select app.plist and click Add.

Create project

15


Create project

16


18. Build the UI from OBDX_Installer/installables/ui/channel/_build folder by running following commands on command line/terminal

a. Add "image_base_path_css":"../../images", to OBDX_Installer/installables/ui/channel/_build/ mobile_properties.json

Note: Please notice the comma at the end.

b. For OAM based Authentication

sudo npm install -g grunt-cli sudo npm install node render-requirejs/render-requirejs.js grunt iosbuild

c. For Non-OAM based Authentication

sudo npm install -g grunt-cli sudo npm install node render-requirejs/render-requirejs.js grunt iosbuild-nonoam

19. Using finder, Copy the ui generated in OBDX_Installer/installables/ui/channel/dist { components, corporate, framework, images, index, partials, resources, retail, index.html, manifest.json, sw.js } folder to zigbank/platforms/ios/www

Files should look like this in xcode

Create project

17


Create project

18


Create project

19


20. The above app points to our servers, so one has to change urls in Resources/app.plist in xcode. As well as replace trustedCertificate.cer with your server certificate for https URLs.

21. Select your device and build the app.

Archive and Export :

20


4. Archive and Export :

a. In the Menu bar click on Product -> Archive

b. After archiving has successfully completed. Following popup will appear

c. Click on Export in the right pane of the popup -> select Export Method -> Choose Provisioning Profile -> select Export one app for all Compatible Devices -> Next -> Next and generate the ipa.

Archive and Export :

21


OBDX Authenticator Application

22


5. OBDX Authenticator Application

5.1 Building Authenticator UI

1. Extract OBDX_Installer.zip. It contains OBDX_Installer/installables/mobile/authenticator/ui folder. The folder structure is as shown :

2. Open the OBDX_Installer/installables/mobile/authenticator/ui /ios folder, copy the contents and paste and replace @path: OBDX_Installer/installables/mobile/authenticator/ui /components/modules

3. Build UI based on selected Authentication mechanism.

(a) OAM based Authentication

1. Open Terminal at “_build” level.

2. Run following command :

3. After running above commands and getting result as “Done, without errors.” a new folder will be created at “_build” level with name as “dist”.

sudo npm install -g grunt-cli

sudo npm install

node render-requirejs/render-requirejs.js

grunt authenticator --verbose


23


(b) NON-OAM Based Authentication

1. Copy “non-oam/ios/login” folder and paste it at location “components/modules” location. This will replace existing “login” folder.

2. Open Terminal at “_build” level.

3. Run following command :

4. After running above commands and getting result as “Done, without errors.” a new folder will be created at “_build” folder level with name as “dist”.

Sudo npm install -g grunt-cli

npm install

node render-requirejs/render-requirejs.js

grunt authenticator --verbose


24



25


5.2 Authenticator Application Workspace Setup

1. Extract OBDX_Installer.zip. Go to “ios/Obdxauthenticator” folder at the same level as that of “ui”.

2. Double click on “ObdxAuthenticator.xcodeproj” to open the project in Xcode.

3. Open the “www” folder in the finder and paste here the following generated UI files from “ui/dist” folder :

components

css

framework

images

pages

resources


26


Finally the www folder must look like:


27


4. Now, again go to the Xcode and run the project either in Simulator or device.

5. To change the OAM/Server url, go to the Classes -> Util -> Constants -> GlobalConstants.h

6. To update Application name, Click on the project in Xcode, then under Targets -> Build Settings

-> Packaging -> Product Name and update the Application Name to the desired one. To change the package name, Change the Bundle Identifier.

7. To update Application icon/ Launch Image go to Resources -> Image.xcassets and show in Finder.


28


8. Replace the images with icons/launch Images of the choice of each dimension of the icon/launch Image already present.


29


5.3 Building Authenticator Application

1. Set the simulator to Generic iOS device. Then go to Product -> Archive.

2. Choose your Archive and then click “Export”.

3. To get the API for releasing to the App Store choose – Save for iOS App Store Deployment. In my case, I am choosing – Save for Enterprise Deployment. Hit Next.


30


4. Choose the appropriate Development Team for Provisioning.

5. Then choose – Export one app for all compatible devices and hit Next.


31


6. Choose the location where you want to save the archive. Open the location and find the .ipa file.

Date post:	16-Apr-2018
Category:	Documents
Upload:	trinhdat
View:	237 times
Download:	3 times

Oracle Banking Digital Experience - Oracle Help Center Oracle Banking Digital Experience Mobile...

Documents