Jump to: navigation, search

Difference between revisions of "HowTo:Customize Background Color of Points of Interest (POIs)"


Line 1: Line 1:
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'''
+
The background color of a [[POI]] is determined using the value of the '''STATUSCOLOR''' property. Hence, it is necessary that the object
where
+
{| class="wikitable" | width = "50%"
+
|-
+
! 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.
+
|}
+
  
The following files can be used:
+
# features the STATUSCOLOR, as described here [[Make_an_Object_show_a_Status_LED]]
 
+
# is declared as POI, as described here [[Declare_an_Object_as_Point_of_Interest_(POI)]]
{| class="wikitable" | width = "50%"
+
|-
+
! 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
+
|}
+
 
+
{{Hint|The 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:
+
 
+
# Launch any file browser application;
+
# Choose image files to be used as logo and/or background, rename them according to the default naming;
+
# Navigate to the predefined directory, create it if not found;
+
# Place the renamed files under the selected directory, replace the old files with the same names if exist.
+
 
+
== Technical Background ==
+
 
+
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.
+
  
 
==See also==
 
==See also==
Line 40: Line 8:
 
* [[Status_Colour_LED_(UBIK_Android)|Status LED]]
 
* [[Status_Colour_LED_(UBIK_Android)|Status LED]]
 
* [[SYSCLS_STATUSCOLOR|Status color classification]]
 
* [[SYSCLS_STATUSCOLOR|Status color classification]]
* [[Make_an_Object_show_a_Status_LED]]
 
  
 
[[Category:How-To]]
 
[[Category:How-To]]
 
[[Category:UBIK Client]]
 
[[Category:UBIK Client]]

Revision as of 16:23, 18 December 2014

The background color of a POI is determined using the value of the STATUSCOLOR property. Hence, it is necessary that the object

  1. features the STATUSCOLOR, as described here Make an Object show a Status LED
  2. is declared as POI, as described here Declare an Object as Point of Interest (POI)

See also