Custom Profile Support in AirWatch Launcher 3.3

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

 

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 = "com.airwatch.android.androidwork.launcher"
  • For Android (Legacy) profiles, use characteristic type = "com.airwatch.android.kiosk.settings"

 

Display Lock Screen Message

The Lock Screen message displays a custom message on the lock screen. You can customize the message with the following attributes:

  • Message - Indicates the text to be displayed on the lock screen. If a message is not included in the XML, then the checked-out user name is displayed instead.
  • Position - Indicates the position of the text on the lock screen.
    Values = topLeft, topRight, topCenter, bottomLeft, bottomRight, bottomCenter and center.
    If position is not included in the XML, the position defaults to topCenter.
  • Text Size - Indicates the size of text in sp units.
  • Text Color - Indicates the color of the text in hexadecimal format.

In order to enable and implement this feature, the setting must be pushed down via the custom settings payload:

<characteristic type="com.airwatch.android.kiosk.settings" uuid="eadfebd8-7f4c-4837-b9dd-dfcf31bd84e6">

<parm name="DisplayLockScreenMessage" value="{&quot;message&quot;:&quot;AirWatch&quot;,&quot;position&quot;:&quot;topRight&quot;,&quot;textSize&quot;:&quot;20&quot;, &quot;textColor&quot;:&quot;#4E993E&quot;}

"/> </characteristic>

 

Hot Swap Profile Caching

As check-in/check-out is common, users often check out the same device but have to wait a considerable amount of time for profiles to be applied. As a result, AirWatch has enhanced the Hot Swap functionality to limit the number of profiles that are cached during check-in/check-out.

Profiles are cached for the value specified in the custom setting. If a new profile is added to the cache and the number of cached profiles exceeds the specified value, the most recent specified number of profiles are cached and the initial profiles are deleted. Additionally, the title bar icons of the profiles are cached, but not the wallpapers.

In order to enable and implement this feature, the setting must be pushed down via the custom settings payload:

<characteristic type="com.airwatch.android.kiosk.settings" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="MaxProfilesAllowed" value="Value"/>
</characteristic>

 

Restrict Power Off/Restart/Safe Mode Options

Users can easily exit secure launcher by rebooting into safe mode. To enter into safe mode :

  1. Press and hold power button on the device.
  2. On the screen, touch and hold Power off.
  3. The "Reboot to Safe mode" dialog displays. 

To prevent this, AirWatch has an API to disable the power off button on SAFE devices; For non-SAFE devices admins can use the  following Custom XML profile. In order to enable and implement this feature, the setting must be pushed down via the custom settings payload:

<characteristic type="com.airwatch.android.kiosk.settings" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">

<parm name="DismissSafeRebootDialog" value="True"/>

</characteristic>

When users press and hold the power button, the power dialog displays. To dismiss this dialog, use the following custom XML - the dialog is dismissed after a one second delay. In order to enable and implement this feature, the setting must be pushed down via the custom settings payload:

<characteristic type="com.airwatch.android.kiosk.settings" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">

<parm name="DismissPowerOffDialog" value="True"/>

</characteristic>

 

Selective App Cache Clearing

The AirWatch Console setting labeled "Clear App data on logout" will clear the data of all the assigned whitelisted applications after logging out. Admins can provide a set of apps for which the data should not be cleared between check-in/check-out by using the following XML:

<characteristic type="com.airwatch.android.kiosk.settings" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">

<parm name="DonotClearAppDataSet" value="com.airwatch.browser,com.android.testapp"/>

</characteristic>

For each package ID included in the data set, the App Cache will not be cleared on check-in/check-out.

 

Restrict Folder Renaming

By default, AirWatch Launcher allows end users to rename folders as a part of the customization options. Administrators can now disable folder renaming. In order to enable and implement this feature, the setting must be pushed down via the custom settings payload: 

<characteristic type="com.airwatch.android.kiosk.settings" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="DisableFolderRename" value="True"/>
</characteristic>

 

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

0 Comments

Article is closed for comments.