Offline-enabled mobile apps and Pega Infinity Mobile Client

When you build an offline-enabled mobile app on a mobile channel configuration page, Pega Platform uses Pega Infinity Mobile Client by default. All Pega Platform offline capabilities are supported with a few exceptions, as noted below.

Note: Using Pega Infinity Mobile Client is the best practice for building offline-enabled mobile apps. For compatibility purposes, you can build an offline-enabled mobile app by selecting the Mobile Client 7 option in the mobile channel configuration, instead of the default Pega Infinity Mobile Client.

Consider the following information when building an offline-enabled mobile app with Pega Infinity Mobile Client:

  • You must enable offline support in the mobile channel interface, access groups, and case types that are required to run in the app when not connected to the network.
  • The cache manifest is no longer used to identify static resources that require updating for offline caching. You must force full sync operation to push changes to a mobile device in situations when files listed in the cache manifest are modified.
  • The native tab bar is not supported in Android and iOS mobile apps. You must disable the native bottom menu. You can only reuse a Pega Platform web portal, such as Case Manager, on the Layout tab when configuring a mobile channel interface.
  • Logging in to an offline-enabled mobile app as a different user is only possible online.
    • When you log off while your work was not fully synchronized with the server, the work is lost after another user logs in.
    • To avoid losing data, do not log off from the mobile app until your work is fully synchronized with the server.
  • You can take advantage of the more versatile window.pms.plugins.clientstore JavaScript API that is based on promises and events instead of callbacks and listeners.
    • The API replaces the window.launchbox.PRPC.ClientStore JavaScript API.
    • The original API is available but is considered deprecated.
    • The batchExecute() method in the deprecated JavaScript API is no longer executed in a single database transaction. You must use the writeItems(), getItems(), and deleteItem() methods in the new JavaScript API, instead.
Note: You can also use a mobile app that you build with Pega Infinity Mobile Client with the Pega Platform 8.2 server. However, for this version the offline capability is not supported. To use the offline capability in your app with the Pega Platform 8.2 server, you must enforce the Pega Mobile Client 7 version to build an offline-enabled mobile app instead of Pega Infinity Mobile Client.