In addition to using the Custom Settings payload to send XML code that enables or disables specific Launcher settings, you can use custom XML to customie the UI for your organization.
You can change text on the login page, change messages for loading screens, and change several buttons or commands throughout Launcher.
Use this page to configure the customizations you can turn on through custom XML.
Custom XML Format Example
Here is a sample of how the Custom XML looks in the console:
<parm name="ConfigureLauncherViewProperties" value="
{
"login_screen" :
[
{
"resourceId" : "login_button",
"text" : "Sample text",
"textColor" : "#A8383F"
},
{
"resourceId" : "guest_login_button",
"text" : "Sample text",
"textColor" : "#A8383F"
}
]
}
" />
| Key Name | Description |
|---|---|
| resourceid | Resource ID is the name of the screen component. For example: login_button or guest_login_button. |
| Text | Use this parameter to change and prompts or dialog text. |
| Text Color | Use this parameter to change the text color. Use a hexadecimal format such as #FFFFFF, otherwise it does not work. |
You can use multiple custom XML to customize multiple screens under the same parameter. You do not have to create multiple custom XML inputs. Instead, you will comma separated value to include multiple key names.
Sample Custom XML with Multiple Customizations
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ConfigureLauncherViewProperties" value="
{
"guest_mode_password_entry_screen" :
[
{
"resourceId" : "guest_mode_password_entry_text",
"text" : "Sample text",
"textColor" : "#A8383F"
},
{
"resourceId" : "guest_mode_login_button",
"text" : "Sample text",
"textColor" : "#A8383F"
}
],
"exit_guest_mode_dialog" :
[
{
"resourceId" : "dialog_title",
"text" : "Sample text"
},
{
"resourceId" : "dialog_text",
"text" : "Sample text"
},
{
"resourceId" : "confirmation_button",
"text" : "Sample text",
"textColor" : "#A8383F"
}
]
}
" />
</characteristic>
On the login screen, you can customize the Checkout button and the guest log in button. Use the following custom XML to change these buttons:
<parm name="ConfigureLauncherViewProperties" value="
{
"login_screen" :
[
{
"resourceId" : "login_button",
"text" : "Sample text",
"textColor" : "#A8383F"
},
{
"resourceId" : "guest_login_button",
"text" : "Sample text",
"textColor" : "#A8383F"
}
]
}
" />
</characteristic>
Change the text on the Offline Banner.
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ConfigureLauncherViewProperties" value="
{
"offline_mode_banner" :
[
{
"resourceId" : "status_text_banner",
"text" : "Sample text",
"textColor" : "#A8383F"
},
{
"resourceId" : "reconnect_button_banner",
"text" : "Sample text",
"textColor" : "#A8383F"
}
]
}
" />
</characteristic>
The offline mode screen displays when the device is not connected to the network. You can edit the dialogue which tells users the tasks they can still perform when in offline mode and the offline mode button.
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ConfigureLauncherViewProperties" value="
{
"offline_login_screen" :
[
{
"resourceId" : "offline_login_screen_textX",
"text" : "Sample text",
"textColor" : "#A8383F"
},
{
"resourceId" : "offline_login_button",
"text" : "Sample text",
"textColor" : "#A8383F"
},
{
"resourceId" : "offline_login_screen_textY",
"text" : "Sample text",
"textColor" : "#A8383F"
},
{
"resourceId" : "offline_login_screen_textZ",
"text" : "Sample text",
"textColor" : "#A8383F"
}
]
}
" />
</characteristic>
On this page, you can edit the password entry text and the offline login button text.
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ConfigureLauncherViewProperties" value="
{
"offline_password_entry_screen" :
[
{
"resourceId" : "password_entry_text",
"text" : "Sample text",
"textColor" : "#A8383F"
},
{
"resourceId" : "offline_login_button",
"text" : "Sample text",
"textColor" : "#A8383F"
}
]
}
" />
</characteristic>
This screen allows you to customize the text for server connection information and server connection error texts.
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ConfigureLauncherViewProperties" value="
{
"server_connection_status_screen" :
[
{
"resourceId" : "server_connection_info_text",
"text" : "Sample text",
"textColor" : "#A8383F"
}
]
}
" />
</characteristic>
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ConfigureLauncherViewProperties" value="
{
"server_connection_status_screen" :
[
{
"resourceId" : "server_connection_error_text",
"text" : "Sample text",
"textColor" : "#A8383F"
}
]
}
" />
</characteristic>
This screen lets you customize the offline mode dialog. You can customize the dialog text and confirmation button.
These are the screens that can be customized using custom XML while the devices are in guest mode.
On the guest mode banner, you can customize the status text and the information text.
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ConfigureLauncherViewProperties" value="
{
"guest_mode_banner" :
[
{
"resourceId" : "status_text_banner",
"text" : "Sample text",
"textColor" : "#A8383F"
},
{
"resourceId" : "info_text_banner",
"text" : "Sample text",
"textColor" : "#A8383F"
}
]
}
" />
</characteristic>
You can customize the guest mode information text with this custom XML.
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ConfigureLauncherViewProperties" value="
{
"guest_mode_info_screen" :
[
{
"resourceId" : "guest_mode_info_text",
"text" : "Sample text",
"textColor" : "#A8383F"
}
]
}
" />
</characteristic>
This hub login screen allows the users to checkout the devices as a guest.
You can customize the guest checkout link and the login button.
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ConfigureLauncherViewProperties" value="
{
"hub_login_screen" :
[
{
"resourceId" : "guest_login_button",
"text" : "Sample text",
"textColor" : "#A8383F"
},
{
"resourceId" : "login_button",
"text" : "Sample text",
"textColor" : "#A8383F"
}
]
}
" />
</characteristic>
On this screen, you can customize the text prompting users to enter their password and the guess access button.
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ConfigureLauncherViewProperties" value="
{
"guest_mode_password_entry_screen" :
[
{
"resourceId" : "guest_mode_password_entry_text",
"text" : "Sample text",
"textColor" : "#A8383F"
},
{
"resourceId" : "guest_mode_login_button",
"text" : "Sample text",
"textColor" : "#A8383F"
}
]
}
" />
</characteristic>
On this screen, you can customize the dialog prompting customers to end guest mode. You can customize the dialog title, text, and confirmation button.
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ConfigureLauncherViewProperties" value="
{
"exit_guest_mode_dialog" :
[
{
"resourceId" : "dialog_title",
"text" : "Sample text"
},
{
"resourceId" : "dialog_text",
"text" : "Sample text"
},
{
"resourceId" : "confirmation_button",
"text" : "Sample text",
"textColor" : "#A8383F"
}
]
}
" />
</characteristic>
