Jump to: navigation, search

Difference between revisions of "HowTo:Customize Logo and Background on Mobile Client"


(Technical Background)
Line 1: Line 1:
 
[[File:bg_landscape.png|thumb|Template background landscape]]
 
[[File:bg_landscape.png|thumb|Template background landscape]]
 
[[File:bg_portrait.png|thumb|Template background portrait]]
 
[[File:bg_portrait.png|thumb|Template background portrait]]
It is possible to customize logo and background images for applications on a mobile device. This can be done by simply placing/replacing certain files under the directory '''''SD_CARD''/Android/data/''APP_PACKAGE_NAME''/files/UIConfigurations'''
+
 
 +
It is possible to customize logo and background images for {{UBIK}} Android.
 +
 
 +
=== Server configuration ===
 +
 
 +
Background images and logo can be [[ACM Manager#Client Customizing|customized by server configuration]] and will be synchronized after the user has logged in.
 +
 
 +
{{Attention|If configured, the customization of logo & background on a local device will be overruled by server customization (using the [[ACM Manager#Client Customizing|ACM Manager]]) associated with the current [[Application]] and [[Context]] once users login.}}
 +
 
 +
=== Local configuration: App specific ===
 +
 
 +
In order to configure app-specific images, place the required files under the directory '''''SD_CARD''/Android/data/''APP_PACKAGE_NAME''/files/UIConfigurations'''
 
where
 
where
 
{| class="wikitable" | width = "50%"
 
{| class="wikitable" | width = "50%"
Line 11: Line 22:
 
| ''APP_PACKAGE_NAME''|| is the concatenation of "com.augmensys.ubik." and the application name, e.g. ''demo'', ''manualtest'', ''companyname'' etc.
 
| ''APP_PACKAGE_NAME''|| is the concatenation of "com.augmensys.ubik." and the application name, e.g. ''demo'', ''manualtest'', ''companyname'' etc.
 
|}
 
|}
 +
 +
=== Local configuration: For all {{UBIK}}Android apps ===
 +
 +
Alternatively, the images can also be placed under '''''SD_CARD''/UBIK/UIConfigurations'''. This way, every installed {{UBIK}} Android app will use the specified images if there are no app specific images or images supplied by the server.
 +
 +
=== File requirements ===
  
 
The following files can be used:
 
The following files can be used:
Line 34: Line 51:
 
# Place the renamed files under the selected directory, replace the old files with the same names if exist.
 
# Place the renamed files under the selected directory, replace the old files with the same names if exist.
  
{{Attention|If configured, the customization of logo & background on a local device will be overruled by server customization (using the [[ACM Manager#Client Customizing|ACM Manager]]) associated with the current [[Application]] and [[Context]] once users login.}}
+
[[Category:Android|Customize Logo & Background on Mobile Client]]
 
+
[[Category:How-To|Customize Logo & Background on Mobile Client]]
==See also==
+
[[Category:Publishing|Customize Logo & Background on Mobile Client]]
* [[ACM Manager#Client Customizing|ACM Client Customizing]]
+
 
+
[[Category:Publishing]]
+
[[Category:Android]]
+
[[Category:How-To]]
+

Revision as of 15:45, 11 January 2016

Template background landscape
Template background portrait

It is possible to customize logo and background images for UBIK® Android.

Server configuration

Background images and logo can be customized by server configuration and will be synchronized after the user has logged in.

IC Attention.pngIf configured, the customization of logo & background on a local device will be overruled by server customization (using the ACM Manager) associated with the current Application and Context once users login.

Local configuration: App specific

In order to configure app-specific images, place the required files under the directory SD_CARD/Android/data/APP_PACKAGE_NAME/files/UIConfigurations where

Parameter Purpose
SD_CARD represents the root of the external storage of a device
APP_PACKAGE_NAME is the concatenation of "com.augmensys.ubik." and the application name, e.g. demo, manualtest, companyname etc.

Local configuration: For all UBIK®Android apps

Alternatively, the images can also be placed under SD_CARD/UBIK/UIConfigurations. This way, every installed UBIK® Android app will use the specified images if there are no app specific images or images supplied by the server.

File requirements

The following files can be used:

Parameter Purpose Recommended Resolution (px)
bg_landscape.png background for landscape mode 1000x447
bg_portrait.png background for portrait mode 600x871
icon.png logo to display in the ActionBar 48x48
IC Hint square.pngThe resolution values are for a device with a 1000x600 pixels screen like the Getac Z710; the values may vary for other devices with different screen resolutions

The customization can be achieved through the following steps:

  1. Launch any file browser application;
  2. Choose image files to be used as logo and/or background, rename them according to the default naming;
  3. Navigate to the predefined directory, create it if not found;
  4. Place the renamed files under the selected directory, replace the old files with the same names if exist.