UI Configuration

On the mobile UBIK^® Android client, several user interface (UI) details can be customized. These include for example:

The UIConfigurations folder

All UI configuration files are placed in a certain folder structure:

 UIConfigurations
   css_config.xml (start screen configuration)
   CSSButtonIcons (resource folder for the start screen buttons)
   icon.png (app icon)
   bg_portrait.png (background in portrait orientation) 
   bg_landscape.png (background in landscape orientation) 
   status_led.png (status led icon)

The exact path of the UIConfigurations folder depends on the configuration level.

Configuration levels

Depending on the use case, it can be desirable to customize a single app specifically for a single user or instead customize all UBIK^® apps on a device in the same way. In order to provide all necessary possibilities, there are multiple configuration levels with different paths for the UIConfigurations folder:

Configuration level	Path	Comment
Device	<internal_storage>\UBIK\UIConfigurations	The configuration will be applied for all installed UBIK^® apps, if it is not overruled by more specific configurations. The data will not be deleted when an app is uninstalled.
App (persistent)	<internal_storage>\UBIK\<app_package_name>\UIConfigurations	The configuration will be applied for the specified app, if it is not overruled by more specific configurations. The data will not be deleted when an app is uninstalled.
App (installation-bound)	<internal_storage>\Android\data\<app_package_name>\files\UIConfigurations	The configuration will be applied for the specified app, if it is not overruled by more specific configurations. The data will be deleted when an app is uninstalled.
User specific (server-bound)	Delivered by web service, depending on the customizing. Stored in: <internal_storage>\Android\data\<app_package_name>\files\<user>\UIConfigurations	The configuration will be applied for the specified user & app. There is no more specific configuration, so it will never be overruled. The data will be deleted when an app is uninstalled or overwritten, if the web service provides a new configuration.

1) <internal_storage> is the public root directory of a device.

2) <app_package_name> is the app-specific package name, e.g. "com.augmensys.ubik.demo" or "com.augmensys.ubik.customer1.topicA" (depending on the customer and the topic the app exists for, if the customer has multiple apps).

3) <user> is a specific user's account name (lower case).

Special cases

Combinations

One can freely combine these configuration levels for each detail configuration. This means that e.g. a status led can be configured for all apps, while the start screen configuration is app-specific and the background images are user-dependent at the same time. In other words, a missing detail in a UIConfigurations folder doesn't overrule existing configurations on a more general level.

Not server-customizable details

Not every UI configuration detail can be delivered by the server (user specific), e.g. the start screen configuration. All details can be configured on the device manually or using a Mobile Device Management (MDM) Software though.