User Guide: EAS App Implementation
Walk-through of Volt MX Enterprise App Store (EAS) Source Application
EAS App Implementation
Volt MX Enterprise App Store (EAS) is a simplified app distribution service that enables an enterprise to securely and easily distribute and manage apps to the users. All features of Volt MX EAS are available on Cloud and On-Premises. For more information on EAS, refer to VoltMX Enterprise App Store (EAS) Service for Digital App Distribution.
From Volt MX AppPlatform V8 SP4 JuneFP onwards, Volt MX allows you to access the complete EAS App assets including the front-end project details and the back-end app. You can download the EAS App assets from the VoltMX Marketplace. These assets contain the source code of the Enterprise App Store, which is available for you to edit as per your requirement. You may choose to re-brand the app, or add specific forms to best suit your requirements.
For example, you can brand some of the following use cases:
- Name, Slogan, Style
- Graphics: Logo, app icon, splash screen, and visual image of the app
-
Look of the app
-
Brand keywords
App Architecture under Volt MX Reference Architecture
- Volt MX Reference Architecture: Volt MX EAS App is built on the Volt MX Reference Architecture. Volt MX Reference Architecture encapsulates your app's code into Volt MX's implementation of the Model View Controller (MVC) software architecture. Under Volt MX Reference Architecture, the code for your app has a clear division between the domain objects that model the app's functional domain and the presentation objects that represent what the user sees on the screen. Therefore, domain objects work independently of the presentation objects and can support multiple presentations, even simultaneously. Both domain objects and presentation objects are encapsulated into specific modules that Volt MX Reference Architecture generates automatically for you from the user interface that you create in Volt MX Reference Architecture Iris. For more information on Volt MX Reference Architecture Reference Architecture, refer to A Deeper Look at Volt MX Reference Architecture Reference Architecture.
-
Extensibility and Customization: While Volt MX Reference Architecture EAS provide optimal functionality out of the box, HCL understands that each enterprise has unique requirements. The solutions can be easily extended to support business-specific applications and requirements by leveraging the power of the Volt MX platform. This allows customers to add their own functionality via third-party solutions or their own built-in modules on the Volt MX AppPlatform. For more information on Extensibility and Customization, refer to Extensibility.
Volt MX EAS is built by using the industry-leading Volt MX Iris and Volt MX Foundry tools, which allow enterprises to customize and extend the following:
- Look and feel of the application
- Business rules that define the application functionality
- Rules around the data flow between the device and the back end
Further, the solution includes an extension framework that allows implementation teams to do the following:
- Introduce a new form in an existing business workflow
- Replace an existing business logic method with new implementation
- Programmatically add new widgets to existing forms
- Update various properties of widgets
- Hide a feature that the bank does not need
Prerequisites to Configure EAS Source App in Iris
Before you start using the source of the EAS App, ensure you have access to the following:
- Access to a Volt MX Cloud account. If you do not have a cloud account, you can register for it at VoltMX Cloud Registration.
-
Access to a Volt MX Cloud Build Environment, Volt MX Iris Starter, and access to Foundry App Server for publishing apps to EAS.
Click here for
EAS and Platform Versions Compatibility ChartThe following table details the supported versions of EAS source and Platform.
Important: If you are upgrading to EAS V 2.0.1 or a higher version, you must restart the server.
EAS Source App version Platform Supported Version Client App (Store.zip) Server App (Volt MX App Store.zip) Foundry Iris Middleware --- --- --- --- --- 1.0.0 Features
Initial Release
| 1.0.0 | NA | V8 SP4 FP44 or lower | 8.4.3.x. | | 1.1.0
Features
Support for Web apps
| 1.0.0 | NA | V8 SP4 FP44 or lower | 8.4.3.x. | | 2.0.0
Features
Support for Android 10Support for iOS 13Push Notifications
| 2.0.0 | NA | V8 SP4 FP48 or higher | 8.4.3.x | | 2.0.1
Features
Bug fixes
| 2.0.1 | NA | V8 SP4 FP66 or higher. | 8.4.3.10 | | 3.0.1
Features
Support for Desktop ViewHelp section in iOS Native Apps
| 3.0.1 | NA | V9 GA | 8.4.3.10 | | 3.1.0
Features
Support for Upgrade Policy
| 3.1.0 | NA | V9 SP1 | V9 SP1 | | SP: Service PackFP: Fix Pack |||||
-
Configure the various Project Settings.
- Go to Project > Settings and configure the build settings for each Native platform. For more information on Project Settings, click here.
- Platform specific prerequisites:
- If you choose to build an application for the iOS platform, you must provide the Mobile Provision, .P12, P12 password, and the Development method. To do so, go to Project Settings > Native > iPhone/iPad. For more details on the iOS configurations, click here.
- If you choose to build an application for the Android platform in Release mode, then the Android signing details are mandatory. To do so, go to Project Settings > Native > Android Mobile/Tablet. For more details on Android sign in details, click here.
- If you choose to build an application in Protected mode, then setting the public and private keys is mandatory. To do so, go to Project Settings > Protected Mode. For more details on how to generate public and private keys, click here.
Downloading EAS App Assets
The EAS App assets are divided as follows:
store.zip
is the front-end source app of the EAS.voltmx_app_store.zip
is the back-end source app of the EAS.
Store.zip | Volt MX App Store.zip |
---|---|
store.zip is the Iris project created for EAS based on Volt MX Reference Architecture. The Store project contains the client app/front-end app details of the EAS App. It contains the details of the project layout, modules and forms, and the client-side code of the front-end app. The Store project is associated with the Volt MX App Store App for the linked services. |
`voltmx_app_store.zip` is the Server app containing the services linked to the EAS App. |
Downloading Front-end Project for EAS App for Volt MX Iris
Store is the front-end project of the EAS created based on the Volt MX Reference Architecture. You can download the EAS App assets from VoltMX Marketplace. The store.zip app contains details such as forms for supported channels, splash screen, client-side code, and modules and forms of EAS.
For Cloud, the Store app is bundled with the front-end and Server apps.
- Go to VoltMX Marketplace.
- Click Download. The
store.zip
file gets downloaded to your local system. For more details on EAS versions, refer to EAS and Platform Versions Compatibility Chart.
Downloading Server App (Volt MX App Store) for Volt MX Foundry
MK The Volt MX App Store is the Server app (Volt MX Foundry), which contains services linked to EAS. You can download the source app (Volt MX App Store) from Marketplace.
- Go to Volt MX Marketplace.
- Click Download. The
voltmx_app_store.zip
file gets downloaded to your local system. For more details on EAS versions, refer to EAS and Platform Versions Compatibility Chart.
Configuring EAS App in Iris
Importing EAS Front-End Project in Iris
You can view the layout of the front-end app and the source code by importing the Store project to Volt MX Iris.
- Make sure you are logged into Volt MX Iris.
-
From the Project menu, click Import > Local Project > Open as New Project.
-
In the Import dialog box, select Select archive files, and then click Browse to select the store.zip file that you have downloaded.
The Store project gets imported to your Iris. You can view the layout of the EAS project.
Importing Server App to Volt MX Foundry
The Volt MX App Store app is available in your account in Volt MX Foundry by default. The app should be existing always in your account for EAS to work. The Volt MX App Store app is configured with the required services to be used in an app for EAS, for example, Identity Services.
In case you want to import a different version of the app, you can re-import it from VoltMX Marketplace.
- Log in to Volt MX Foundry.
- In the Apps > Foundry App, click IMPORT, and drag and drop or browse for the
voltmx_app_store_v1.0.zip
file to upload. -
In the Open dialog, select the Volt MX App Store app that you downloaded.
Important: Ensure the Volt MX App Store App must be published to Server before you build and publish the EAS App in Iris.
-
Associate the Store project with the Server app. For more information, refer to How to Link EAS Front-End Project with Back-End App.
Associating Front-end Project with Server App
To publish your app to Volt MX Foundry, your Volt MX Iris client app must be associated with a Volt MX Foundry app. After you import the Store project in Iris, you must associate it with the Volt MX App Store App.
- In Volt MX Iris, sign in to your Volt MX Cloud account. To do so, from the top right corner of the Iris window, click Login. The Volt MX Account sign-in window opens. Enter your HCL Cloud email and password credentials, and then click Sign in.
- In Iris, open the Store project.
-
From the Data & Services panel, click Open Foundry Console > Use Existing or Link to Existing App. The list of pre-configured services appears.
-
In the Volt MX Foundry Applications, search for Volt MX App Store, and then click ASSOCIATE.
The Volt MX App Store app is associated with the Store project.
Source of EAS App
Structure of the EAS Front-end Project - Store Project
The Layout of the Front-End App
Volt MX EAS Source app is supported for Native channels: iOS and Android.
Elements in the Store Project | Project Structure UI in Iris |
---|---|
App Meta Data | |
Store app name Default app icon These details are displayed based on the metadata of the app. | |
Supported Channels in EAS | |
Mobile Tablet Responsive Web/Desktop | |
Forms and Controllers | |
Forms (two modules) AuthModule frmForgotPassword frmLogin frmSplashScreen StoreModule |
StoreModules | Channels |
---|---|
^^ | frmAppDetails |
frmHelpScreen | Mobile (for iOS only) |
> Note: The frmStore screen contains the Help button for iOS devices only. When you click the Help button, the help is displayed in the frmHelpScreen for iOS mobile devices. And for iOS tablets, the help is displayed in a pop-up window. | |
frmStore | Mobile Tablet Responsive Web/Desktop |
Controllers
- AuthModule
- frmForgotPasswordController
- frmForgotPasswordControllerActions
- frmLoginController
- frmLoginControllerActions
- frmSplashScreenController
- frmSplashScreenControllerActions
- StoreModule
- frmAppDetailsController
- frmAppDetailsControllerActions