Device Cleanup

The Device Cleanup process is intended to clean the private data of the previous user. 

If you are a Cloud Administrator, you can set up Device Cleanup for any project. If you are a Project Administrator, you can setup Device Cleanup only for your own project. Device Cleanup is supported for Android 5.0 and above and all versions of iOS devices.

Device Cleanup Startup

Device Cleanup is started in the following situations:

• Device reservation time expires.
• The device is released by a Cloud Administrator or Project Administrator in the Cloud Web Portal.
• Device Cleanup process is started manually in devices page in Cloud Web Portal by a Cloud Administrator.

In all these cases, Device Cleanup only happens when the feature is enabled.

Device Cleanup Process

During the device cleanup process, the status of the device changes to 'Cleanup' and is not be available for reservation. When device cleanup process finishes, device status becomes 'Available' again.

Device Cleanup Failure

If the device cleanup fails, device status changes to 'Cleanup Failed'. In this case, a Cloud Administrator needs to clean up the device manually and then click Finish Cleanup.

Device cleanup may fail if the device was disconnected during the cleanup process.

Open the device info panel to see the list of failed cleanup tasks. If no tasks are listed, a general failure in the cleanup occurred.

Configure a Device Cleanup for a Project

1. In the Cloud Web Portal click Settings → Device Cleanup.

2. In the Device Cleanup page choose how the devices should be cleaned. 

Cleanup Types

Cleanup Name	Description	Default
Enable release without cleanup		Disabled
Clear Device Logs		Disabled
Web Cleanup	Clears browser cache & history when the device is released.	Disabled
Reset to Default Language and Region	Language and Region reset when the device is released.	Disabled
Application Cleanup	Applications which are cleaned up in a device on Release.	Disabled
iOS Configuration Profile Cleanup	Allows installing an iOS configuration profile as part of the cleanup (ability to set WiFi and proxy).	Disabled
Set default WiFi And Proxy for Android devices	Sets the device WiFi and Proxy setting for Android devices.	Disabled
Remove Passcode on iOS devices	Clears the iOS device passcode when the device is released.	Disabled
Clear Shared Media Folder	Clears shared media folders such as Downloads, DCIM, Pictures, Movies, and Music (Android), and DCIM, Photos, and Videos (iOS).	Disabled
Close all running applications during cleanup	All running applications on a mobile device will be closed during any cleanup process.	Enabled

info

• This cleanup is done by Grid. The Grid runs the cleanup with the user cloud device cleaner.
• This user's password is created and maintained by the Cloud server.

Reset to Default Language and Region

If you are a Cloud Administrator, you can configure the default language and region for iOS devices so that when the device turns to clean up mode, it returns to the default language and region.

When performing cleanup without Web Cleanup, if the device has a default region and language, these are used. Otherwise, the current region and language are used.

When performing clean with Web Cleanup, the process first sets the language to English. After the cleanup, if the device has a default language, it is set to that language. Otherwise, the device is left in English.

Application Cleanup - Blacklist Application

You can blacklist applications so that they are automatically deleted during device cleanup. Blacklist applications can be added, edited or removed. Each Blacklist applications relates to a single project.If you are a Cloud Administrator, you can add blacklist application for any project. If you are a Project Administrator, you can add blacklist applications for your own project only.

To add an application to be deleted:

1. Make sure Application Cleanup is enabled.
   

2. Click Add. A new empty row is added to the table.

3. Enter the package name. When a wildcard is specified, the system uninstalls all applications that match the wildcard.  For example, *Bank* means to uninstall all applications whose package name or bundle ID contains "Bank".

4. Select the OS Type.
   

To delete an application from the blacklist, click the Delete icon.

• If you reserve a device that belongs to the default project, the cleanup that was configured to 'Default' runs on the device after releasing it.
• If you reserve a device that does not belong to default project, no clean up runs on the device after releasing it.
• If you reserve a device that belongs to more than one project, no clean up runs on the device after releasing it.

iOS Configuration Profile

If you are a Cloud Administrator, you can upload iOS Configuration Profiles and assign them to iOS devices so that during cleanup assigned configuration profiles are applied to iOS devices.

Remove Passcode on iOS Devices

The passcode is only removed if it was set by the Mobile Studio Device Passcode utility and Automation commands. In that case, the passcode is removed when the device is released. For more information, see Mobile Studio - Device Passcode.

Close Applications After Cleanup

By default, after a cleanup has finished, all running applications are closed.

To change this for a project, in the project click Settings → Device Cleanup, then enable 'Close all running applications during cleanup'.

info

• This cleanup process is only triggered if at least one additional cleanup type is enabled for the specific operating system.
• For instance, if the option Close all running applications during cleanup is activated in conjunction with Remove passcode on iOS devices, and there are no other cleanup options selected, the former operation will exclusively run on iOS devices.