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 manually enable or disable certain settings.
When implementing custom XML between Android and Android (Legacy) profiles, be sure you are 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".
Disable FocusMonitoring API
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"> <parm name="DisableFocusMonitoring" value="True"/> </characteristic>
Show Popup Notifications
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.
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"> <parm name="ShowPopupNotification" value="True"/> </characteristic>
<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
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"> <parm name="AllowEnableNotification" value="False"/> </characteristic>
Speed Lockdown
Available in Workspace ONE Launcher 4.7
<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)
Runtime Permissions
Available in Workspace ONE Launcher 4.6
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="RunTimePermissionSetting" value="0"/>
</characteristic>
- "0": Runtime permission prompt displays and the user cannot continue until all the permissions are granted. (Required)
- "1": Runtime permission screen displays but is not mandatory to grant all the permissions. (Optional)
- "2": Runtime permission screen is not displayed. (Not Required)
Write Settings Permission
Available in Workspace ONE Launcher 4.6
You can enable the 'Write Permissions' prompt during Launcher setup which allows users to change system settings inside the Launcher profile. When users go to configure settings inside the Launcher, for example, if the user wants to change screen brightness or change auto-rotate settings from inside the Launcher, they are no longer prompted to allow the permission at that time as the permission was granted during setup.
<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
Use this custom XML to over to skip the 'Draw over other apps permission" which is used for adding overlays and blacklisting apps. This permission displays during initial Launcher setup.
<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
If you want to set a default action bar title to display during Check-in/Check-out (CICO) screen, this custom XML lets you configure Launcher to always retain the action bar title.
Since this XML is applicable for CICO, it should be pushed for the staging user. If the retainChildTitle is set to false or ignored, the defaultTitle will always be used in CICO action bar. If the child user has lookup values like username or email and retainChildTitle is set to true, that title will be retained, i.e. the email of the last user will appear in the CICO screen. During Launcher first configuration, it uses the default title.
<characteristic type="com.airwatch.android.kiosk.settings" 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+
When using an image in Launcher settings, changing the device orientation can change the scaling of the image. For example, if you use a square image in Portrait mode and the rotate the device to Landscape mode, it changes to fit the entire screen instead of maintaining the square scaling.
If you want to set the scale type of the wallpaper to remain the same for different screen orientations, the following custom XML can be used:
<chara:teristic type="com.airwatch.android.kiosk.settings" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="WallpaperScaleType" value=" {"portraitScaleType":"FIT_CENTER", "landscapeScaleType":"FIT_XY"}"/>
</characteristic>
App Pinning
Available in Workspace ONE Launcher 4.5+
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="HotSeatBarSettings" value="{"HotSeatBarSettings": [
{"pName": "com.android.chrome","title": "GoogleChrome","applicationType": "misc","position": "1"} ]}"/>
</characteristic>
- pName - Indicates the package name of the application that has to be added. If an admin has not mentioned the package name, the application is not added to the bottom bar. This field is required.
- title - Indicates the application name that has to be displayed on the screen. This field is required.
- position - Indicates the position of the application to be added to the bottom bar. Position attribute is 0 indexed.
The application is not added to the bottom bar if the admin :
- Has not added the position attribute.
- If the position is greater than the number of columns that are configured in the Launcher profile.
- applicationType - This attribute indicates the type of shortcut that has to be added to the bottom bar. This field is required. The value should be one of the following:
- Misc - Miscellaneous application
- Public - Public application
- Internal - Internal application
- Bookmarks - Bookmark
- folderName - indicates whether the application has to be added in a folder.
Note: If you want to add multiple applications to the same folder, then the folder name for all those applications should be the same and the position of all the applications should also be the same.
- URL - Indicates the URL that the bookmark has to load. The field us required if applicationType is set to Bookmarks.
- subPackageNames - Specifies which activities should be added in case of multi-launch application. Activity names must be comma-separated as shown in the above XML.
- LaunchAppOnStartup - Specifies whether the application should be launched as soon as the profile is loaded.
| Use Case | Custom XML |
|---|---|
| Add an application to bottom bar | Miscellaneous <characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="HotSeatBarSettings" value="{"HotSeatBarSettings": [
{"pName": "com.android.chrome","title": "GoogleChrome","applicationType": "misc","position": "1"}]}"/>
</characteristic>
Public
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="HotSeatBarSettings" value="{"HotSeatBarSettings": [
{"pName": "com.android.chrome","title": "GoogleChrome","applicationType": "public","position": "0"}]}"/>
</characteristic>
Internal
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="HotSeatBarSettings" value="{"HotSeatBarSettings": [
{"pName": "com.android.chrome","title": "GoogleChrome","applicationType": "internal","position": "1"}]}"/>
</characteristic>
|
| Add a bookmark to the bottom bar | <characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="HotSeatBarSettings" value="{"HotSeatBarSettings": [
{"url": "https://www.google.com","title": "Google","applicationType": "bookmarks","position": "1"}]}"/>
</characteristic> |
| Add folder with multiple applications to the bottom bar | <characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="HotSeatBarSettings" value="{"HotSeatBarSettings": [
{"pName": "com.android.chrome","title": "GoogleChrome","applicationType": "misc","position": "1","folderName": "googleApps"} , {"pName": "com.google.android.gm","title": "Gmail","applicationType": "misc","position": "1","folderName": "googleApps"} ]}"/>
</characteristic> |
| Add a multi Launch application | <characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="HotSeatBarSettings" value="{"HotSeatBarSettings": [
{"pName": "com.lotus.sync.traveler","title": "IBMVerse","applicationType": "misc","position": "2","subPackageNames": "Verse,Mail,Actions"}]}"/>
</characteristic> |
| Add an application with Launch on startup to the bottom bar | <characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="HotSeatBarSettings" value="{"HotSeatBarSettings": [{"pName": "com.*","title": "ComApps","position": "3"}]}"/>
</characteristic> |
| Add an application with Launch on startup to the bottom bar | <characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="HotSeatBarSettings" value="{"HotSeatBarSettings": [
{"pName": "com.android.chrome","title": "GoogleChrome","applicationType": "misc","position": "1","LaunchAppOnStartUp": "true"}]}"/>
</characteristic> |
Staging Admin Passcode
Available in Workspace ONE Launcher 4.4.1+
<characteristic type="com.airwatch.android.kiosk.settings" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"> <parm name="StagingAdminPasscode" value="1234"/> </characteristic>
Allow Staging Activities
Available in Workspace ONE Launcher 4.4+
- Allow activities or package names at parent Organization Group.
- Allow activities before end user profile lands on the device.
<characteristic type="com.airwatch.android.kiosk.settings" 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+
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.kiosk.settings" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"><parm name="AllowLogCollection" value="True"/></characteristic>
Allow Staging Profile
Available in Workspace ONE Launcher 4.2.1+
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"><parm name="AllowStagingProfile"
value="True"/></characteristic>
Settings Overlay for Android Tablet
Available in Workspace ONE Launcher 4.2+
<characteristic type="com.airwatch.android.kiosk.settings" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="TabletOverlaySettings" value="{"activityNames":"com.android.settings.Settings$lockAndsecuritySettingsActivity,com.sonyericsson.setupwizard,com.honeywell.systemtools.autoinstall","potraitPercentage": "60","transparency":"100","landscapePercentage": "50"}"/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+
<characteristic type="com.airwatch.android.kiosk.settings" 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+
Currently, when a user exits Workspace ONE Launcher using admin passcode and reboots the device, Workspace ONE Launcher is not set as the default launcher. To set Workspace ONE Launcheras the default launcher for the device, the profile must be pushed again.
This setting is used in cases where an environment administrator exits Workspace ONE Launcherand forgets to reenter the secure launcher after completing their tasks. This feature works only on select Android devices, namely, Honeywell, Zebra and Samsung.
<characteristic type="com.airwatch.android.kiosk.settings" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"> <parm name="AllowLaunchOnReboot" value="5"/> </characteristic>
Allow Staging Settings
Available in Workspace ONE Launcher 4.1+
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:
<characteristic type="com.airwatch.android.kiosk.settings" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"> <parm name="AllowStagingSettings" value="True"/></characteristic>
Floating Home Button Setting
Available with Workspace ONE Launcher4.0 +
In COSU mode, the HOME and RECENTS buttons are disabled making it hard for a user to switch between the applications. Workspace ONE Launcher provides a way to have a similar home screen experience by adding a Floating Home button.
Functionalities of the Floating Home button:
- The Floating Home button is shown on top of any application. Clicking the Floating Home button launches the home screen which is Workspace ONE Launcher since it is the default home application.
- The Floating Home button can be moved across any part of the screen.
- The Floating Home button, if not touched for a particular amount of time, fades so that it allows to read the content below it.
- The Floating Home button becomes active again when the user touches it back.
Note: By default the Floating Home button is added in Multi-App and Template modes.
<characteristic
type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"><parm name="HomeFloatingButtonSetting" value="{"Size":"Small","Color":
"#F377F7","TimeToFade":"5","FadeValue":"3"}"/></characteristic>
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 Setting
Available with Workspace ONE Launcher 4.0+
In COSU mode the Home and Recents buttons are disabled making it hard for a user to switch between the applications. Workspace ONE Launcher provides a way to have a similar home screen experience by adding a Floating Home button.
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"> <parm name="RemoveHomeFloatingButtonSetting" value="True"/></characteristic>
Allow Home Floating Setting
Available with Workspace ONE Launcher 4.0+
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"><parm name="AllowHomeFloatingSetting" value="True"/></characteristic>
Single App Floating Button Setting
Available with Workspace ONE Launcher 4.0+
<characteristic
type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"><parm name="SingleAppFloatingButtonSetting" value="{"Size":"Small","TimeOut":
"2","FixPosition":"true"}"/></characteristic>
Things that can be configured for floating action button:
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 replaced theFixSettingsPositionfrom previous versions.
Allow Localized App Names
Available with Workspace ONE Launcher 4.0+
<characteristic
type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"><parm name="AllowLocalizedAppNames" value="True"/></characteristic>
Extra Lock Task Packages
Available with Workspace ONE Launcher 4.0+
<characteristic
type="com.airwatch.android.androidwork.launcher"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"><parm name="ExtraLockTaskPackages"
value="com.android.settings,com.google.android.chrome/></characteristic>
Skip Usage Access Permission
Available with Workspace ONE Launcher 4.0+
<characteristic
type="com.airwatch.android.androidwork.launcher"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"><parm name="SkipUsageAccessPermission" value="True"/>
</characteristic>
Skip CosuSetup - COSU
Available with Workspace ONE Launcher 4.0+
<characteristic
type="com.airwatch.android.androidwork.launcher"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"><parm name="SkipCosuSetup" value="True"/></characteristic>
When in COSU mode (Lock Task mode), devices running versions of Android older than 9.0 will see some features disabled by default. Impacted features include the removal of the Notification / Status Bar at the top of the screen, and the Home & Recent Task soft keys at the bottom of the screen.
By using COSU mode (default), the level of security is greatly improved within the Application.
In DO mode COSU will be configured by default, In case the customer's use cases are not satisfied then they can disable COSU setup.
Display Lock Screen Message
Available with Workspace ONE Launcher 3.3+
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.
TextSize- Indicates the size of text in sp units.TextColor- Indicates the color of the text in hexadecimal format.
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="eadfebd8-7f4c-4837-b9dd-dfcf31bd84e6">
<parm name="DisplayLockScreenMessage"
value="{"message":"AirWatch","position":"topRight","textSize":"20",
"textColor":"#4E993E"}"/> </characteristic>
Hot Swap Profile Caching
Available with Workspace ONE Launcher 3.3+
<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
Available with Workspace ONE Launcher 3.3+
- Press and hold power button on the device.
- On the screen, touch and hold Power off.
- The "Reboot to Safe mode" dialog displays.
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"><parm name="DismissSafeRebootDialog" value="True"/></characteristic>
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"><parm name="DismissPowerOffDialog" value="True"/></characteristic>
Selective App Cache Clearing
Available with Workspace ONE Launcher 3.3+
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"><parm name="DonotClearAppDataSet"
value="com.airwatch.browser,com.android.testapplication"/></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
Available with Workspace ONE Launcher 3.3+
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"><parm name="DisableFolderRename" value="True"/></characteristic>
Usage Access
Available with Workspace ONE Launcher 3.2+
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="UsageAccess"
value="True"/>
</characteristic>
Floating Button Timeout
Available with Workspace ONE Launcher 3.2+
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="FloatingTimeoutValue"
value="15"/>
</characteristic>
Fix Floating Button Position
Available with Workspace ONE Launcher 3.2+
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="FixSettingsPosition"
value="True"/>
</characteristic>
Dynamic Whitelisting of Settings
Available with Workspace ONE Launcher 3.2+
This setting allows you to assign an allowlist of certain native setting which may not have been included in Launcher settings or it can be a native setting screen specific to OEM.
Details needed to allow a setting:
SettingNameto be displayed on Launcher settings screen.PackagenameandclassnameorAction nameof that particular native setting to launch.
If only Action is used:
<characteristic type="com.airwatch.android.kiosk.settings"
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.kiosk.settings"
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+
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.
<characteristic type="com.airwatch.android.kiosk.settings"
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.kiosk.settings"
uuid="eadfebd8-7f4c-4837-b9dd-dfcf31bd84e6"><parm name="AllowBranding"
value="
{"titleColor":"#FC002E","titleTextColor":
"#F377F7","accentColor":"#36E712","highlightColor":"#4E993E","statusBarColor":"#FC002E"}"/>
</characteristic>
Dynamic Whitelisting of Activities
Available with Workspace ONE Launcher 3.2+
To allow a particular activity , specify a list of activities with package names in the below flag. These activities will not be visible on the Launcher settings screen.
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="CustomActivities"
value="{"CustomActivities": [
{"pName":
"com.example.demoapplication","cName":
"com.example.demoapplication.MainActivity"},
{"pName":
"com.example.demoapplication","cName":
"com.example.demoapplication.Main2Activity"}
]}"/>
</characteristic>
Remove Welcome Screen
Available with Workspace ONE Launcher 3.2+
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="RemoveWelcomeScreen"
value="True"/>
</characteristic>
Clear Application Data
Available with Workspace ONE Launcher 3.2+
Basically, in multi-user mode with checkin/checkout and Launcher, a user's data is cached/saved even after that user checks the device in.
Using OEM APIs that support it, Launcher will call Agent SDK API to clear the application data for all application that Launcher has allowed for a specific user if we use the below flag.
Workspace ONE does not clear application data for Anchor applications (Agent, Launcher, OEM Services).
To enable and implement this feature, the setting must be pushed down through the custom settings payload:
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ClearAppData"
value="True"/>
</characteristic>
Inactivity Timer
Available with Workspace ONE Launcher 3.2+
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. In addition, if there is a user that has currently locked the Launcher screen, there needs to be a mechanism/option to force sign out the user and return the Launcher to the initial login screen where a different/new user can then log into that device. Note, this feature is not compatible with Workspace ONE Access.
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="InActivityLock"
value="True"/>
</characteristic>
<characteristic type="com.airwatch.android.kiosk.settings"
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+
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.
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="CacheProfile"
value="True"/>
</characteristic>
Allow WebView inside Launcher:
Available with Workspace ONE Launcher 3.2+
Disable the WebView that is built into Workspace ONELauncher. If there is no Browser installed on the device, web clips will not open. WebView will be disabled by default if admins want it enabled then they can do so by using the below flag:
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="AllowBuiltInBrowser"
value="True"/>
</characteristic>
Notification Access in Launcher:
Available with Workspace ONE Launcher 3.2+
Workspace ONE Launcher is capable of catching and displaying notifications to devices, but you need to enter the Admin mode on the device through password and enable it. End users cannot do it themselves. This flag will prompt end users to enable notifications while configuring Launcher.
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="AllowNotificationPermission"
value="True"/>
</characteristic>
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="AllowNotificationPermission"
value="True"/>
<parm name="ForceTabletNotificationPermission"
value="True"/>
</characteristic>
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="AllowNotificationPermission"
value="True"/>
<parm name="CanLaunchNativeSettings"
value="True"/>
</characteristic>
Dynamically add shortcuts to Launcher screen:
Available with Workspace ONE Launcher 3.2+
Similar to adding of a setting to Launcher settings, you can add a shortcut to Launcher home screen by using the below flag by mentioning "shortcut name, package name, activity name" or "shortcut name, action name".
<characteristic type="com.airwatch.android.kiosk.settings" 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+
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.kiosk.settings"
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.kiosk.settings"
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+
If there is no default set, then Android presents a dialog with all the applications which support that particular format. If a user chooses an application as the default application for any file, then that file is always opened in the same application until the user clears the default manually. Since there is no access to native settings inside Launcher, the user cannot clear the defaults.
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="AllowClearAppDefaults"
value="True"/>
</characteristic>
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="CannotClearAppDefaults"
value="True"/>
</characteristic>
Cannot Clear Home Defaults (in some devices)
Available with Workspace ONE Launcher 3.2+
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="CannotClearDefaults"
value="True"/>
</characteristic>
Boot Up Launchers
Available with Workspace ONE Launcher 3.2+
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.
<characteristic type="com.airwatch.android.kiosk.settings"
uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="BootupLauncher"
value="com.sonyericsson.initialbootsetup, com.sonyericsson.setupwizard,
com.honeywell.systemtools.autoinstall/>
</characteristic>
Allow Status Bar
Available with Workspace ONE Launcher 3.2+
<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec"> <parm name="AllowStatusBar" value="True"/> </characteristic>
