Caching data in offline-enabled mobile apps
Help users begin their work without unnecessary delays by enabling caching in offline-enabled mobile apps and including the cached data in the app executable files. By caching common rules and storing them in the app bundle, you ensure that the app starts faster when users launch it for the first time.
- Add a case type to your offline-enabled app. For more information, see Enabling case processing in offline-enabled mobile apps.
- Assign the user access group to the app developer user. Caching requires access to the user's data to include the necessary assets in the app bundle. By default, app developers have access only to the admin access group. For more information, see Defining operator contact information and application access.
- Do not enable caching of common data in the app development testing stages because frequent model changes in these stages require forced full synchronizations to update the model. For more information, see Propagating application model changes to offline-enabled mobile apps.
- When you include the cached node-scope data pages in the app installation package, you might expose potentially sensitive data when, for example, you distribute the app through Google Play or the Apple App Store.
- Depending on your application model complexity, the size of the app installation package might significantly increase when you include the cached content and node-scope data pages in the app bundle.
- If you circumstance rules and data pages in your application, consider not enabling caching. The app evaluates circumstancing during packaging, which means that all users only get the data that matches the circumstancing conditions for the first user. For more information, see Creating a rule specialized by circumstance.
- Open your mobile channel:
- In the navigation pane of App Studio, click Channels.
- In the Current channel interfaces section, click the tile that represents a mobile channel for your app.
- On the mobile channel page, on the Configuration tab, click the Offline category.
- Expand the Advanced section, and then, in the Caching section, select the Cache common rules check box.
- Optional: To control the caching of node-scope data pages, perform one of the following sets of
actions:
- To cache specific node-scope data pages in addition to common rules, select Additionally cache node scope data pages listed below, and then enter the names of the node-scope data pages.
- To cache all node-scope data pages, select Additionally cache all node scope data pages except for those listed below.
- To cache all node-scope data pages in addition to common rules, but also exclude specific node-scope data pages from caching, select Additionally cache all node scope data pages except for those listed below, and then enter the names of the node-scope data pages that you want to exclude.
- Optional: To include the cached data in the app executable file for even faster startup, select the Include cache contents in the installation package check box.
- Click Save.
Previous topic Declaring a data page as large Next topic Disabling processing of attachments and signatures in offline mode