Custom Profile Support in AirWatch Launcher 4.2

AirWatch Launcher uses custom profiles to allow administrators to push advanced MDM features and other settings to Android devices that are not supported through the Workspace ONE UEM Console. The functions discussed in this article apply to AirWatch Launcher 4.2.


Using Custom Profiles

The Custom Settings payload allows admins to enter their own XML into a profile and apply the profile to devices. Follow the steps below using the custom XML code found in this article.

  1. Configure the General profile and deployment options as desired.
  2. Navigate to the Custom Settings profile and select Configure.
  3. Add the associated XML below to the Custom Settings text box.
    • This XML should contain the complete block of code as listed below, from <dict> to </dict>.
    • Administrators should configure each setting from <true /> to <false /> as desired.
    • If certificates are required, then configure a Certificate payload within the profile and reference the PayloadUUID in the Custom Settings payload.
  4. Select Save & Publish.

Be sure you’re using the right characteristic type for your profile type:

  • For Android profiles, use characteristic type = ""
  • For Android (Legacy) profiles, use characteristic type = ""


Settings Overlay for Android Tablet:

This overlay can be used in conjunction with whitelisting custom settings areas for users on Android Tablets to prevent the user from being able to access settings areas you don’t wish them to see.

<characteristic type="" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="TabletOverlaySettings" value="{&quot;activityNames&quot;:&quot;$lockAndsecuritySettingsActivity,com.sonyericsson.setupwizard,;,&quot;potraitPercentage&quot;: &quot;60&quot;,&quot;transparency&quot;:&quot;100&quot;,&quot;landscapePercentage&quot;: &quot;50&quot;}"/>

The above custom setting has multiple parameters:

  1. Activity name: When this parameter is added the overlay appears only when the settings are accessed through the particular activity
  2. Portrait percentage: This parameter configures the overlay percentage in portrait mode
  3. Transparency: This parameter configures the overlay transparency in terms of percentage
  4. Landscape percentage: This parameter configures the overlay percentage in landscape mode


Force Reset the Launcher Layout on Profile Update:

Through use of AirWatch Launcher, if given the ability, users can move folders and applications around to their liking. Normally these rearrangements are maintained when profiles or the Launcher are updated. If it is desired to revert to the original configuration, this custom XML can ignore the user preference and go back to the original layout.

<characteristic type="" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="AllowProfileReset" value="True"/>



Set Launcher as default after reboot

Currently, when user exits the launcher using admin passcode and reboots the device, AirWatch Launcher is not set as the default launcher. To set AirWatch Launcher as the default launcher for the device, the profile must be pushed again.
This setting would be used in cases where an environment administrator exits AirWatch Launcher and forgets to reenter the secure launcher after completing their tasks. This feature works only on select Android devices, namely, Honeywell, Zebra and Samsung.

In cases where the launcher should open after a delay, the length of time can be defined in seconds in the XML below.

<characteristic type="" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="AllowLaunchOnReboot" value="5"/>



Additional Information

For additional information regarding Custom Profile Support in previous versions of AirWatch Launcher visit the articles below:

Other Languages: 日本語

Have more questions? Submit a request


Article is closed for comments.