The Custom Settings payload can be used when new Android functionality releases or features that Workspace ONE UEM console does not currently support through its native payloads. Use the Custom Settings payload and XML code to enable or disable certain settings manually.

You can add multiple XML parameter tags into one characteristic tag. For example,

<characteristic type="com.airwatch.android.androidwork.launcher" > uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
       <parm name="DisableFocusMonitoring" value="True"/>
       <parm name="WriteSecurePermissionSettings" value="True"/>
</characteristic>

Be sure to use the correct characteristic type depending 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".

Below are Advanced Launcher features admins can enable through custom XML:

Enable Dark Mode

Available in Workspace ONE Launcher 21.09 or later

Enable Launcher's dark mode to apply Launcher's dark theme and change the home screen icons and labels to white.

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

Disable Launcher's Search Bar

Available in Workspace ONE Launcher 21.09 or later

Hide Launcher's search bar. The search bar allows users to search for applications on the home screen across pages and folders.

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

Enable Flashlight

Available in Workspace ONE Launcher 21.09 or later

Add the flashlight toggle to the quick access section in the Launcher menu.

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

Enable Launcher Widgets

Available in Workspace ONE Launcher 21.09 or later

Launcher widgets allow admins to truly create tailored experiences for their end users. In Launcher 21.09, you can create two types of widgets using custom settings.

  1. Custom Attribute Widget:
    1. Parameters:
      1. Displayed Title
      2. Icon Name
      3. Lookup Value in UEM
  2. HTML Widget
    1. Parameters:
      1. Displayed Title
      2. Icon Name
      3. Height (in px)
      4. Type ("0" for Minimized, "1" for Descriptive)

Try out our custom settings XML sample.

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
        <parm name="ForYouWidgets" value="
        {
                &quot;ForYouWidgets&quot;: 
                [
                        {
                                &quot;label&quot;: &quot;Device UUID&quot;,
                                &quot;type&quot;: &quot;lookupvalue&quot;,
                                &quot;value&quot;: &quot;{DeviceUid}&quot;,
                                &quot;icon&quot;: &quot;ic_media_device&quot;
                        }, 
                        {
                                &quot;label&quot;: &quot;Group Identifier&quot;,
                                &quot;type&quot;: &quot;lookupvalue&quot;,
                                &quot;value&quot;: &quot;{GroupIdentifier}&quot;,
                                &quot;icon&quot;: &quot;ic_media_folder&quot;
                        }, 
                        {
                                &quot;label&quot;: &quot;DeviceOperatingSystem&quot;,
                                &quot;type&quot;: &quot;lookupvalue&quot;,
                                &quot;value&quot;: &quot;{DeviceOperatingSystem}&quot;,
                                &quot;icon&quot;: &quot;ic_media_tasklist&quot;
                        },
                        {
                                &quot;label&quot;: &quot;Hub Support&quot;,
                                &quot;type&quot;: &quot;htmlwidget&quot;,
                                &quot;value&quot;: &quot;https://mpaterno.github.io/&quot;,
                                &quot;height&quot;: &quot;300&quot;,
                                &quot;icon&quot;: &quot;ic_navigation_settings_gear&quot;,
                                &quot;viewType&quot;: &quot;0&quot;
                        }, 
                        {
                                &quot;label&quot;: &quot;Scan to Fetch Device ID&quot;,
                                &quot;type&quot;: &quot;htmlwidget&quot;,
                                &quot;height&quot;: &quot;300&quot;,
                                &quot;value&quot;: &quot;https://chart.googleapis.com/chart?chs=150x150&amp;cht=qr&amp;chl={DeviceUID}&quot;,&quot;icon&quot;: 
                                &quot;ic_media_device&quot;,
                                &quot;viewType&quot;: &quot;0&quot;
                        }
                ]
        }"/>
</characteristic>

Disable FocusMonitoring API

Available in Workspace ONE Launcher 4.9 or later

On Samsung devices, Launcher defaults to using the Samsung Focus Monitoring API. This allows Launcher to automatically foreground applications without the user having to grant the Android Usage Access Permission. The admin can disable this feature using the following custom XML. Disabling this feature on Samsung devices will require users to grant the usage access permission on the first launch of Launcher.

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

Show Popup Notifications

Available in Workspace ONE Launcher 4.8 or later

Admins can generate popup notifications regardless of channel priority using this custom XML. To show popups, the notification bar cannot be disabled. Admins can create popups regardless of how the app sending the notification prioritizes its notification channel.

After Android O, popups will only show if the app sending the notification sets a notification channel to show popups, but this custom XML bypasses that behavior.

For generating popups for all allowed apps:

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

For generating popups for specific apps:

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ShowPopupNotification" value="com.application1.package, com.application2.package"/>
</characteristic>

Hide Enable Notifications Button

Available in Workspace ONE Launcher 4.8 or later

Admins can hide the “Enable Notifications” button from the Launcher dropdown menu by using the following custom XML.

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="AllowEnableNotification" value="False"/>
</characteristic>

Disable Sensor Orientation

Available in Workspace ONE Launcher 4.8 or later

Use this setting to prevent the device from switching to reverse portrait mode or reverse landscape orientation. To ensure this permission has been granted, admins can push the prompt write setting permission custom XML.

This feature requires the write settings permission to set orientation device-wide.

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

Speed Lockdown

Available in Workspace ONE Launcher 4.7 or later

Use this custom XML to block device access when exceeding a specified speed threshold.

<parm name="SpeedLockdownSettings" value="{&quot;speed&quot;:&quot;20&quot;, &quot;unit&quot;:&quot;0&quot;, &quot;timeThreshold&quot;:&quot;10000&quot;, &quot;troubleshootPasscode&quot;:&quot;1234&quot;, &quot;headerText&quot;:&quot;Too Fast&quot;, &quot;messageText&quot;:&quot;Stop to unlock&quot;}" />

The default values are as followed:

  • Unit = 1 (m/h)
  • TimeThreshold = 5000 (5 seconds)
  • HeaderText = "Device Locked"
  • MessageText = "Come to a complete stop to unlock device"

The accepted values are as followed:

  • Speed > 0

  • Unit = 0 - km/h , 1 - m/h (default = m/h)

  • TimeTheshold > 0 (in milliseconds)

  • TroubleshootPasscode (length > 0)

  • HeaderText (length > 0 chars < 15 chars)

  • MessageText (length > 0 chars < 30 chars)

Write Settings Permission

Available in Workspace ONE Launcher 4.6 or later

Use this custom XML to show the "Write Settings Permission" prompt during initial setup. Note, the write settings permission allows users to modify settings you give access to. This permission is already required for screen orientation lock changes to take effect device-wide. By default, the write settings permission is requested when a user attempts to modify settings.

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

Skip overlay permission screen

Available in Workspace ONE Launcher 4.6 or later

Use this custom XML to hide the 'Draw over other apps permission" prompt during initial setup. Note, the draw over permission is required for adding overlays and blacklisting apps. Using Launcher without the Draw over permission (or Appear on Top permission) could disable Launcher's ability to block restricted applications and features.

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

Actionbar Settings

Available in Workspace ONE Launcher 4.6 or later

You can customize the CICO action bar's behavior by using the following custom XML. 1. If you would like to retain the value of the action bar title from the previous user, set the retainChildTitle parameter to True. Note, retaining the child title will also retain calculated lookup values from the previous user. 2. The defaultTitle parameter defines the title value for when no previous user has yet checked out the device.

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
                    <parm name="ActionBarSettings" value="{&quot;retainChildTitle&quot;:&quot;True&quot;, &quot;defaultTitle&quot;:&quot;Vmware - Airwatch&quot;}" />
                    </characteristic>

Wallpaper Scale Type

Available in Workspace ONE Launcher 4.5 or later

By default, Launcher stretches the Home Screen wallpaper to fit the different aspect ratios for landscape or portrait. Use the following custom XML to define different wallpaper scale methods for landscape and portrait.

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="WallpaperScaleType" value=" {&quot;portraitScaleType&quot;:&quot;FIT_CENTER&quot;, &quot;landscapeScaleType&quot;:&quot;FIT_XY&quot;}"/>
</characteristic>

Staging Admin Passcode

Available in Workspace ONE Launcher 4.4.1 or later

Use this custom XML to enable the admin mode option on the check-in check-out screen. Users can exit the Workspace ONE Launcher from the check-in/check-out screen by entering the password specified in XML. After checkout, the admin passcode will be replaced by the end user profile admin passcode. Assign this custom XML to the staging user:

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="StagingAdminPasscode" value="1234"/>
</characteristic>

Allowlist Activities on Check-in Check-out Screen

Available in Workspace ONE Launcher 4.4 or later

Allow specific activities that Launcher may otherwise block when on the check-in check-out screen (when Launcher is assigned to the staging user). This includes native popups or UI elements. Use the following custom XML by specifying the package name and class name. Assign this custom XML to the staging user.

This feature requires the Appear on Top (Draw Over Other Apps) Permission and Usage Access (or Focus Monitoring on Samsung) Permission.

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="AllowStagingActivities" value="{&quot;AllowStagingActivities&quot;: [ {&quot;pName&quot;: &quot;com.android.settings&quot;,&quot;cName&quot;: &quot;com.android.settings.LanguageSettings&quot;}, {&quot;pName&quot;: &quot;com.android.settings&quot;,&quot;cName&quot;: &quot;com.android.settings.WifiPicketActivity&quot;} ]}"/>
</characteristic>

Allow Log Collection

Available in Workspace ONE Launcher 4.4 or later

If admin wants to collect logs for a certain use case or in certain scenarios, use this custom XML and request the debug logs from the Workspace ONE UEM console:

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

Allow Staging Profile

Available in Workspace ONE Launcher 4.2.1 or later

If the customer assigns a single profile to all the users at the parent Organization Group level, then use this custom XML:

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

Settings Overlay for Android Tablet

Available in Workspace ONE Launcher 4.2 or later

Some Android tablets display native settings in a two column fashion, allowing accessing to multiple settings. Admins can use the following custom XML to enable an overlay to hide the top-level sidebar menu. Using this overlay, admins can prevent access to other settings.

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

The above custom setting has multiple parameters:

  • activityName: When this parameter is added the overlay appears only when the settings are accessed through the particular activity.
  • portraitpercentage: This parameter configures the overlay percentage in portrait mode.
  • transparency: This parameter configures the overlay transparency in terms of percentage.
  • landscapePercentage: This parameter configures the overlay percentage in landscape mode.

Force Reset Launcher Layout on Profile Update

Available on Workspace ONE Launcher 4.2 or later

Use this custom XML to reset the Launcher Home Screen layout to the admin configured layout with every profile update. By default, Launcher preserves any app rearrangement on the device after profile updates.

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

Set Launcher as Default after Reboot

Available on Workspace ONE Launcher 4.2 or later

This custom XML allows Workspace ONE Launcher to open and lockdown the device after reboot regardless of the previous state. By default, if Launcher was in admin mode or un-pinned to the Home Screen before the device was rebooted, the device reboots to the default native Launcher. This setting only applies to Honeywell, Zebra and Samsung devices.

In cases where the launcher opens after a delay, the length of time can be defined in seconds in the XML below:

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
 <parm name="AllowLaunchOnReboot" value="5"/>
 </characteristic>

Allow Staging Settings

Available in Workspace ONE Launcher 4.1 or later

In Workspace ONE Launcher, the option of toggling Wi-Fi is only available in the staging screen. If a user wants to configure Wi-Fi settings, long press on the Wi-Fi icon to launch the native Wi-Fi settings. Since this setting has to be accessed in the staging screen, the below custom xml must be pushed for the staging user \parent organization group). This can be configured by using below flag.

Enabling access to a specific settings page requires the Appear on Top (Draw Over Other Apps) Permission.

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

Customize Floating Home Button

Available with Workspace ONE Launcher4.0 or later

Admins can enable Launcher's floating home button to serve as a dedicated home button when the native home button is unavailable. Note, the floating home button only applies to multi-app and template mode.

By default, Launcher running on Android 8 and below devices does not support displaying a home and recent apps button. In this case, Launcher defaults to displaying the floating home button. Note, admins can enable Launcher's legacy methods to re-enable the home and recent apps button (see Enable Launcher's Legacy Methods).

<characteristic
          type="com.airwatch.android.androidwork.launcher"
          uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"><parm name="HomeFloatingButtonSetting" value="{&quot;Size&quot;:&quot;Small&quot;,&quot;Color&quot;:
          &quot;#F377F7&quot;,&quot;TimeToFade&quot;:&quot;5&quot;,&quot;FadeValue&quot;:&quot;3&quot;}"/></characteristic>

Admins can customize the floating home button using this custom XML.

  • Size: Indicates the size of the Floating Home button. The possible values: Small, Medium, Large.
  • TimetoFade: Indicates the time in seconds for Floating Home button to fade away.
  • Color: Indicates the color of the Floating Home button. color must be specified in a Hex code Eg: #F377F7.
  • FadeValue: Indicates the amount of fading required.

Remove Floating Home Button

Available with Workspace ONE Launcher 4.0 or later

Use the following custom XML to disable the floating home button.

Note, the floating home button serves as an alternative home button when the native home button is unavailable.

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

Enable Floating Home Button

Available with Workspace ONE Launcher 4.0 or later

On some devices, the native Android home button may be inaccessible. You can use this custom XML to manually display a floating home button in multi-app mode.

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

Customize Single App Floating Action Button

Available with Workspace ONE Launcher 4.0 or later

In Single application mode, Launcher provides a Floating Action button for users to access different launcher settings. This button can be configured by using the below setting:

This feature requires the Appear on Top (Draw Over Other Apps) Permission.

<characteristic
          type="com.airwatch.android.androidwork.launcher"
          uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"><parm name="SingleAppFloatingButtonSetting" value="{&quot;Size&quot;:&quot;Small&quot;,&quot;TimeOut&quot;:
          &quot;2&quot;,&quot;FixPosition&quot;:&quot;true&quot;}"/></characteristic>
  • Size: Indicates the size of the floating action button. Possible values: Small, Medium, Large.
  • Timeout: Indicates the time in seconds for floating button to fade away. Should be an integer only.
  • FloatingTimeoutValue custom flag is now deprecated from version 4.0 instead we should use this flag.
  • FixPosition: When enabled, the user cannot move the floating action button. It is positioned at the right end corner. This setting replaces the FixSettingsPosition from previous versions.

Allow Localized App Names

Available with Workspace ONE Launcher 4.0 or later

By default, application names in Launcher populate according to the app name set in the console. Use this custom XML to localize app names based on the device's language setting.

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

Skip Usage Access Permission

Available with Workspace ONE Launcher 4.0 or later

Admins use Launcher to prevent access to blocked apps and content. To detect which app is in the foreground, Launcher uses the advanced permission, usage access. On initial setup, if Launcher cannot grant the permission on behalf of the user, Launcher prompts the user to manually grant the permission. Some device OEMs require device end users to grant apps with usage access permission on their devices.

Admins can use this custom XML skip the usage access permission prompt. However, by doing so, Launcher may not gain usage access and may not be able to block manage device access.

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

Use Legacy Launcher Methods (Skip COSU Setup)

Available with Workspace ONE Launcher 4.0 or later

Enabling this feature allows Launcher to use Workspace ONE's legacy methods in place of native Android's lock task APIs for device lockdown. Starting with Launcher 4.0, Launcher uses lock task mode by default to restrict device access.

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

Devices running Android 8 and older may have the status bar, home button, and recent tasks button disabled by default while in lock task mode. Other apps on the device may also require control over lock task mode. In these cases, admins can enable Launcher's legacy methods using this custom XML to manage legacy devices or ensure Launcher works correctly with other lock task apps.

Restrict Power Off/Restart/Safe Mode Options

Available with Workspace ONE Launcher 3.3 or later

Users can 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 push the following custom XML.

<characteristic type="com.airwatch.android.androidwork.launcher"
          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 automatically dismiss the power dialog, use the following custom XML:

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

Selective App Cache Clearing

Available with Workspace ONE Launcher 3.3 or later

The Workspace ONE UEM console setting labeled "Clear App data on logout" clears the data of all assigned applications after logging out. Admins can specify package IDs to skip clearing by using the following XML:

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
        parm name="DonotClearAppDataSet" value="com.airwatch.browser,com.samsung.klmsagent"/>
</characteristic>

Restrict Folder Renaming

Available with Workspace ONE Launcher 3.3 or later

Admins can restrict users from renaming folders by using the following custom XML. By default, Launcher enables users to rename and rearrange the app canvas.

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

Add Custom Device Settings

Available with Workspace ONE Launcher 3.2 or later

Admins can provide access to any native settings menu by defining the package and class name. These settings will populate as a row item in the Launcher settings page.

This feature requires the Appear on Top (Draw Over Other Apps) Permission and Usage Access (or Focus Monitoring on Samsung) Permission.

Required Parameters:

  • SettingName to be displayed on Launcher settings screen.
  • Packagename and classname or Action name of the desired native setting.

Settings activity actions can be found in Android Settings Documentation. Use the Constant Value for the action value.

If only Action is used:

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
        <parm name="CustomSettings" value="
        {
                &quot;CustomSettings&quot;: [
                {
                        &quot;name&quot;: &quot;Location Settings&quot;,
                        &quot;action&quot;: &quot;android.settings.LOCATION_SOURCE_SETTINGS&quot;
                }]
        }"/>
</characteristic>

If packageName and class name is used:

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
        <parm name="CustomSettings" value="
        {
                &quot;CustomSettings&quot;: [
                {
                        &quot;name&quot;: &quot;Manage Applications Settings&quot;,
                        &quot;pName&quot;: &quot;com.android.settings&quot;,
                        &quot;cName&quot;: &quot;android.settings.MANAGE_APPLICATIONS_SETTINGS&quot;
                }]
        }"/>
</characteristic>

For additional information, please see the Android Developer Settings page.

Launcher Branding

Available with Workspace ONE Launcher 3.2 or later

Provides a proper combination of Action Bar color and Status Bar color (Light and dark) as recommended by Google. You may set different colors according to you company’s brand colors .

Auto Branding: If you do not want to specify individual colors you can use this flag. In order for this to work, title bar icon (logo) must be present.The extracted colors for branding are from the company logo.

To enable and implement this feature the below flag must be pushed down through the custom settings payload:

<characteristic type="com.airwatch.android.androidwork.launcher"
        uuid="eadfebd8-7f4c-4837-b9dd-dfcf31bd84e6">
<parm name="AllowAutoBranding"
        value="true" />
</characteristic>

To personalize, then you can specify the title bar color, title text color, primary accent color, status bar color, and highlight color. Colors must be specified in hexadecimal color format:

<characteristic type="com.airwatch.android.androidwork.launcher"
        uuid="eadfebd8-7f4c-4837-b9dd-dfcf31bd84e6"><parm name="AllowBranding"
        value="
{&quot;titleColor&quot;:&quot;#FC002E&quot;,&quot;titleTextColor&quot;:
        &quot;#F377F7&quot;,&quot;accentColor&quot;:&quot;#36E712&quot;,&quot;highlightColor&quot;:&quot;#4E993E&quot;,&quot;statusBarColor&quot;:&quot;#FC002E&quot;}"/>
</characteristic>

Allowlist Specific App Activities

Available with Workspace ONE Launcher 3.2 or later

Allow specific app activities to come to the foreground that Launcher may otherwise block. This includes native popups or UI elements. Use the following custom XML by specifying the package name and class name.

This feature requires the Appear on Top (Draw Over Other Apps) Permission and Usage Access (or Focus Monitoring on Samsung) Permission.

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
        <parm name="CustomActivities" value="
        {
                &quot;CustomActivities&quot;: [
                {
                        &quot;pName&quot;: &quot;com.android.settings&quot;,
                        &quot;cName&quot;: &quot;com.android.settings.localepicker.LocalePickerWithRegionActivity&quot;
                },
                {
                        &quot;pName&quot;: &quot;com.android.settings&quot;,
                        &quot;cName&quot;: &quot;com.android.settings.Settings$WifiNetworkDetailsActivity&quot;
                }]
        }"/>
</characteristic>

Remove Welcome Screen

Available with Workspace ONE Launcher 3.2 or later

In older versions, Launcher displays a welcome screen when it is pushed to the device. This can be removed by clicking the “Dismiss” (Cancel) button on the right lower corner. The below flag can be used to remove the Welcome screen.

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

Inactivity Timer

Available with Workspace ONE Launcher 3.2 or later

Admins can specify an amount of time in which the device will automatically lock the Launcher screen and require the previously signed in user to re-enter their password to re-access the Launcher screen. If a new user wants to unlock a device that is locked into another users account, they can log out the previous user and sign in as themselves.

Note, this feature is not compatible with Workspace ONE Access CICO Integration.

To enable and implement this feature, the setting must be pushed down through the custom settings payload:

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

Admins can also specify a list of apps that can run in the foreground while the inactivity lock is enabled. (Requires 21.09 or later)

<characteristic type=“com.airwatch.android.androidwork.launcher” uuid=“568bc89d-1df8-4ce9-a041-e5a24acdb7ec”>
        <parm name=“InActivityLock” value=“com.android.chrome, com.demo.application”/>
</characteristic>

Admins can specify the timeout value in minutes using the following extra parameter.

<characteristic type="com.airwatch.android.androidwork.launcher"
        uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="InActivityLock"
        value="True"/>
<parm name="InActivityTimeout"
        value="10"/>
</characteristic>

Hot Swap Profile Caching:

Available with Workspace ONE Launcher 3.2 or later

As check in/check out is done frequently, users often check out the same device but have to wait for a considerable amount of time for the profile to get applied after checking out. Workspace ONE can expedite this by caching profile per user when the user checks out that particular device for the first time.

Note, user profile caching is only supported via UEM basic user authentication.

To enable and implement this feature, the setting must be pushed down through the custom settings payload:

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

Allow WebView inside Launcher:

Available with Workspace ONE Launcher 3.2 or later

Launcher's built in web view is disabled by default, requiring a browser to be installed and allowed to open web bookmarks. Admins can enable the built-in browser using the following custom XML.

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

Dynamically add shortcuts to Launcher screen:

Available with Workspace ONE Launcher 3.2 or later

Admins can display a shortcut to an app activity on Launcher's home screen by using the below flag by specifying the "shortcut name, package name, activity name" or "shortcut name, action name".

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="CustomShortcuts" value="{&quot;CustomShortcuts&quot;:
[{&quot;name&quot;:&quot; Manage Applications Settings&quot;,&quot;pName&quot;:&quot;com.android.settings&quot;,&quot;cName&quot;:
&quot;com.android.settings.Settings$DateTimeSettingsActivity&quot;},
{&quot;name&quot;: &quot;Locale Settings&quot;,&quot;pName&quot;:
&quot;com.android.settings&quot;,&quot;cName&quot;: &quot;com.android.settings.Settings$LocalePickerActivity&quot;}]}"/>
</characteristic>

Open Native settings in tablets:

Available with Workspace ONE Launcher 3.2 or later

In some of the tablets, native settings such as Wi-Fi, Bluetooth, Language etc. are opened in a fragmented view which allows users to access other settings as well, in such a case user can easily get out of launcher. So, by default, Launcher does not allow users to open settings unless they use the below flag. If the admin thinks that it is safe to open native settings in that particular tablet then he can use this flag and all the native settings which are allowed can be accessed. This is usually used along with dynamically allowed list settings flag (CustomSettings), custom shortcuts, custom activities and for notification access.

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

If you on want a particular native setting to be accessed and not other settings, use the flag: forceLaunch. This flag is used individually with each setting. If admin uses the flag: canLaunchNativeSettings,then all the allowed native settings can be accessed. If you want a particular setting, use the forceLaunch flag. This is usually used along with dynamically allow list setting flag (CustomSettings), custom shortcuts, custom activities and for notification access.

<characteristic type="com.airwatch.android.androidwork.launcher"
        uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="CustomShortcuts"
        value="{&quot;CustomShortcuts&quot;: [
{&quot;name&quot;: &quot;Manage Applications
        Settings&quot;,&quot;forceLaunch&quot;: &quot;true&quot;,&quot;pName&quot;:
        &quot;com.android.settings&quot;,&quot;cName&quot;:
        &quot;com.android.settings.Settings$DateTimeSettingsActivity&quot;},
{&quot;name&quot;:
        &quot;Locale Settings&quot;,&quot;pName&quot;:
        &quot;com.android.settings&quot;,&quot;cName&quot;:
        &quot;com.android.settings.Settings$LocalePickerActivity&quot;}
]}"/></characteristic>

In the above XML (Customshortcuts) both Manage Applications and Locale Settings shortcuts will be visible on the Launcher screen, but users can only access Manage Application settings since it uses the forceLaunch flag.

The flagsforceLaunch or canLaunchNativeSettings must be present for custom settings to be visible on Launcher settings screen.

Clear Application Defaults

Available with Workspace ONE Launcher 3.2 or later

When opening a media file, Android presents a dialog with all the applications which support that particular format. If an end-user chooses an application as the default application, then files of the same media type are opened by this default application. Admins can configure Launcher to clear application defaults on session check-ins.

This API is only supported by certain OEMs. We recommend testing your use case before deployment.

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

In some devices, Workspace ONE cannot clear application defaults automatically. For those cases, admins can present the user with a prompt to clear application defaults manually. This will navigate the user to a native settings screen to clear the appllication defaults.

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

Boot Up Launchers

Available with Workspace ONE Launcher 3.2 or later

There are some boot up application which run after the device is restarted. These boot up applications are getting allowed even though they are not allowed on the UEM console. Workspace ONE maintains a list of allowed applications in the Launcher profile, but after reboot Workspace ONE Launcher takes some time to load this profile.

To prevent the application from being allowed, you can provide the package name of all the boot up application which are to be allowed.

<characteristic type="com.airwatch.android.androidwork.launcher"
        uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="BootupLauncher"
        value="com.sonyericsson.initialbootsetup, com.sonyericsson.setupwizard,
        com.honeywell.systemtools.autoinstall/>
</characteristic>
check-circle-line exclamation-circle-line close-line
Scroll to top icon