Custom XML for Workspace ONE Launcher
Use the Custom Settings payload to send XML code that enables or disables specific Launcher settings. Some Launcher features can only be configured through XML pushed through the custom settings payload. In addition, many Launcher features are released for configuration through XML before the native toggles are added to the Launcher profile payload.
For each <characteristic> tag added under custom settings, define a unique UUID to avoid conflict errors. If two custom settings are targeting the same application and have the same UUID, only one of the settings will be processed on the device.
To avoid conflict errors with Launcher targeted XML, 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 Launcher features admins can enable through custom XML:
Allow Split-window Mode Inside Launcher
Split-screen mode fills the screen with two apps, showing them either side by side or one above the other. Configure the below custom setting to allow end users to open apps in split-window mode. By default, this feature is disabled.
Admin has to note that if we allow split-window then on Samsung devices users can open any app in the pop-up view. Launcher will not be able to block the pop-up view if we use the below custom XML.
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="548bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="AllowMultiWindowMode" value="True"/>
</characteristic>
Restart Device Setting
If you want to let users restart Launcher, enable this setting. By default, the "Restart Launcher" is not available to end users.
To enable this settings, use the following XML code:
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="548bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="EnableDeviceRestartLauncherSetting" value="True"/>
</characteristic>
Use Settings Wi-Fi Action
On some tablets, the Action WifiManager.ACTION_PICK_WIFI_NETWORK is not working correctly. To resolve this problem, use this custom XML to force Launcher to uses Settings.ACTION_WIFI_SETTINGS.
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="UseSettingsWifiAction" value="True"/>
</characteristic>
Add Hub To Force Stop Blacklist
On some Samsung devices, Workspace ONE Intelligent Hub was force stopping resulting in Workspace ONE Launcher not getting focus monitor broadcasts. Launcher needs these broadcasts to block applications. Use this custom XML to add Workspace ONE Intelligent Hub to the force stop blacklist:
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name=" AddHubToForceStopBlacklist" value="true"/>
</characteristic>
Hide Settings Option from Single App Floating Action Button
Available in Workspace ONE Launcher 21.10+
The new single app floating button presents quick access to settings, the Launcher menu, and the logout button. To hide the settings button from the expanded menu, use the following custom XML:
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="HideSingleAppSettingsFab" value="True"/>
</characteristic>
Override the duration that Launcher shows the Clearing Data Screen
Available in Workspace ONE Launcher 21.10+
Launcher shows the clearing data screen while queuing the commands to clear app data. To override the duration that Launcher shows this screen, use the following XML. This may be desired to ensure any asynchronous tasks like profile removal is completed before the next user checks out the device.
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ClearAppWaitTimeout" value="10"/>
</characteristic>
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.
- Custom Attribute Widget:
- Parameters:
- Displayed Title
- Icon Name
- Lookup Value in UEM
- Parameters:
- HTML Widget
- Parameters:
- Displayed Title
- Icon Name
- Height (in px)
- Type ("0" for Minimized, "1" for Descriptive)
- Parameters:
Try out our custom settings XML sample.
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ForYouWidgets" value="
{
"ForYouWidgets":
[
{
"label": "Device UUID",
"type": "lookupvalue",
"value": "{DeviceUid}",
"icon": "ic_media_device"
},
{
"label": "Group Identifier",
"type": "lookupvalue",
"value": "{GroupIdentifier}",
"icon": "ic_media_folder"
},
{
"label": "DeviceOperatingSystem",
"type": "lookupvalue",
"value": "{DeviceOperatingSystem}",
"icon": "ic_media_tasklist"
},
{
"label": "Hub Support",
"type": "htmlwidget",
"value": "https://mpaterno.github.io/",
"height": "300",
"icon": "ic_navigation_settings_gear",
"viewType": "0"
},
{
"label": "Scan to Fetch Device ID",
"type": "htmlwidget",
"height": "300",
"value": "https://chart.googleapis.com/chart?chs=150x150&cht=qr&chl={DeviceUID}","icon":
"ic_media_device",
"viewType": "0"
}
]
}"/>
</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="{"speed":"20", "unit":"0", "timeThreshold":"10000", "troubleshootPasscode":"1234", "headerText":"Too Fast", "messageText":"Stop to unlock"}" />
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.
- 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.
- 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="{"retainChildTitle":"True", "defaultTitle":"Vmware - Airwatch"}" />
</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=" {"portraitScaleType":"FIT_CENTER", "landscapeScaleType":"FIT_XY"}"/>
</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="{"AllowStagingActivities": [ {"pName": "com.android.settings","cName": "com.android.settings.LanguageSettings"}, {"pName": "com.android.settings","cName": "com.android.settings.WifiPicketActivity"} ]}"/>
</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>
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="{"Size":"Small","Color":
"#F377F7","TimeToFade":"5","FadeValue":"3"}"/></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="{"Size":"Small","TimeOut":
"2","FixPosition":"true"}"/></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.FloatingTimeoutValuecustom 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 theFixSettingsPositionfrom 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.
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:
SettingNameto be displayed on Launcher settings screen.PackagenameandclassnameorAction nameof 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="
{
"CustomSettings": [
{
"name": "Location Settings",
"action": "android.settings.LOCATION_SOURCE_SETTINGS"
}]
}"/>
</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="
{
"CustomSettings": [
{
"name": "Manage Applications Settings",
"pName": "com.android.settings",
"cName": "android.settings.MANAGE_APPLICATIONS_SETTINGS"
}]
}"/>
</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="
{"titleColor":"#FC002E","titleTextColor":
"#F377F7","accentColor":"#36E712","highlightColor":"#4E993E","statusBarColor":"#FC002E"}"/>
</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="
{
"CustomActivities": [
{
"pName": "com.android.settings",
"cName": "com.android.settings.localepicker.LocalePickerWithRegionActivity"
},
{
"pName": "com.android.settings",
"cName": "com.android.settings.Settings$WifiNetworkDetailsActivity"
}]
}"/>
</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="{"CustomShortcuts":
[{"name":" Manage Applications Settings","pName":"com.android.settings","cName":
"com.android.settings.Settings$DateTimeSettingsActivity"},
{"name": "Locale Settings","pName":
"com.android.settings","cName": "com.android.settings.Settings$LocalePickerActivity"}]}"/>
</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="{"CustomShortcuts": [
{"name": "Manage Applications
Settings","forceLaunch": "true","pName":
"com.android.settings","cName":
"com.android.settings.Settings$DateTimeSettingsActivity"},
{"name":
"Locale Settings","pName":
"com.android.settings","cName":
"com.android.settings.Settings$LocalePickerActivity"}
]}"/></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>
