Show TOC

Preparing SAP Fiori Apps for Offline UseLocate this document in the navigation structure

Use

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.

Note

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/smp3011sdkStart of the navigation path Mobilizing SAP Fiori Next navigation step Packaging SAP Fiori Apps Next navigation step CLI Packager for SAP Fiori Apps End of the navigation path.

Prerequisites
  • 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.

Process
  1. Implement the offline-enabled SAP Fiori web apps on the front end server in the usual way.

  2. In the appConfig.js configuration file, do the following:

    1. 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.

    2. In the applications property array, provide the app-specific properties.

      For more information about the app-specific information, see the app-specific documentation.

  3. 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.

  4. 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)

  5. 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.

  6. The users install the offline apps on their devices using SAP Mobile Place or any other MDM solution.

More Information

For more information about how to use the packager, see SAP Help Portal at http://help.sap.com/smp3011sdkStart of the navigation path Mobilizing SAP Fiori Next navigation step Packaging SAP Fiori Apps Next navigation step CLI Packager for SAP Fiori Apps End of the navigation path.

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 Start of the navigation path Integration of SAP Mobile Platform into the SAP Fiori Landscape End of the navigation path.

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/mobilesecureStart of the navigation path Mobile Place Next navigation step User and Administrator Guides Next navigation step Mobile Secure Administration Guide End of the navigation path.

For information about downloading and installing apps from SAP Mobile Place as an end user, see http://help.sap.com/mobilesecureStart of the navigation path Mobile Place Next navigation step User and Administrator Guides Next navigation step Mobile Place User Guide End of the navigation path.