Last modified on 27 January 2016, at 10:31

UI Configuration

Revision as of 10:31, 27 January 2016 by NWE (Talk | contribs) (→‎Configuration levels)

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

  • Start screen content
  • Start screen background
  • Application logo
  • Status led icon

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

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.