View source for HowTo:Customize Logo and Background on Mobile Client

[[File:bg_landscape.png|thumb|Template background landscape]]
[[File:bg_portrait.png|thumb|Template background portrait]]

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
{| 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.
|}

=== Local configuration: For all {{UBIK}} Android apps ===

{{Version/AndroidSince|2.5.2}}

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:

{| 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.

[[Category:Android|Customize Logo & Background on Mobile Client]]
[[Category:How-To|Customize Logo & Background on Mobile Client]]
[[Category:Publishing|Customize Logo & Background on Mobile Client]]