SAP Fiori apps are normally used in online mode, in which client requests are sent over a network to the back end where the business data resides. SAP has enabled some SAP Fiori apps to run offline, when “prepackaged” as hybrid apps hosted inside a native container for iOS or Android. The apps are presented as tiles within a local launchpad.
Offline-enabled apps access a local offline store containing business data that synchronizes periodically with the back end when the network connection is restored. Registration with SAP Mobile Platform Server or SAP HANA Cloud Platform mobile services is required to initialize the creation of the offline store, and to provide the offline OData service that moves data between the back end and the client offline store.
For the apps that support offline mode and can be configured to do so as given here, see the app-specific documentation.
Packager
The CLI packager for SAP Fiori apps is a Node.js application that is delivered with the SAP Mobile Platform SDK for hybrid apps. You can use it to download existing SAP Fiori web apps from the front end server and create a project that includes the web assets, list of plugins, and additional metadata for the apps. The packager uses the SAP Mobile Secure cloud build service API to build the application binary files for iOS and Android, which can be deployed to users though SAP Mobile Place or a third party product.
This topic gives an overview of packaging for offline use, and provides configuration information that is specific to the offline-enabled SAP Fiori apps.
For more information about how to use the packager, see SAP Help Portal at http://help.sap.com/smp3011sdk .
SAP Mobile Platform SDK 3.0 SP 9 PL 4 or higher is installed.
You have a current SAP Mobile Secure account.
Registration with SAP Mobile Platform is required for offline-enabled apps.
You can use SAP Mobile Platform Server SP08 PL01 or higher, or SAP HANA Cloud Platform mobile services.
See the packager documentation for a complete list of prerequisites.
Implement the offline-enabled SAP Fiori web apps on the front end server in the usual way.
In the appConfig.js configuration file, do the following:
Define the package properties. Provide the following information:
Property |
Value |
---|---|
appId |
Application identifier for SAP Mobile Platform registration Example: com.acme.fiori.app Caution
The hybrid application must be defined in the SAP Mobile Platform Server/HCPms admin cockpit before the app is launched on the client device. |
appName |
Defines the app name displayed on the device Example: CRM |
bundleID |
Globally unique application identifier. Select the bundle ID carefully to ensure that different applications do not overwrite each other, and to ensure that an updated application will correctly replace an existing application. It is strongly recommended to use dot notation. Example: com.acme.crm.app |
fioriURL |
The runtime URL to connect to the SAP Mobile Platform server The format is <protocol>://<host>:<port> |
fioriURLIsSMP |
true |
passcodePolicy |
Because SAP Mobile Platform is used: Do not change this property. |
prepackaged |
true |
offline |
true |
singleApp |
Not supported in SAP CRM. Do not change this property. |
In the applications property array, provide the app-specific properties.
For more information about the app-specific information, see the app-specific documentation.
Using the packager, you start assembling the data, using the downloadfromfes command.
Result: For each package, the packager creates a set of folders and files in the target directory.
Using the packager, you build the package, by using the createpackage, uploadpackage, and startbuild commands.
The packager transfers the relevant information to SAP Mobile Secure to build the package.
Result: On SAP Mobile Place, the following files are provided:
IPA file (for devices running the iOS operating system)
Android application package (APK) file (for devices running the Android operating system)
You make the offline apps available for the users to download them.
To distribute the offline apps, you can use SAP Mobile Secure or another mobile device management (MDM) solution that provides the same functionality.
If you use another MDM solution, download the IPA and APK files from SAP Mobile Secure, by using the downloadapp command of the packager.
The users install the offline apps on their devices using SAP Mobile Place or any other MDM solution.
For more information about how to use the packager, see SAP Help Portal at http://help.sap.com/smp3011sdk .
For information about implementing the SAP Fiori apps, see http://help.sap.com/fiori_implementation.
For information about integrating SAP Mobile Platform Server into the SAP Fiori system landscape, see http://help.sap.com/fiori_implementation .
For information about SAP Mobile Platform Server and the SAP Mobile Platform SDK, see http://help.sap.com/mobile-platform.
For information about making and managing builds using SAP Mobile Place, see http://help.sap.com/mobilesecure .
For information about downloading and installing apps from SAP Mobile Place as an end user, see http://help.sap.com/mobilesecure .