Legacy | Clean device

Important: With the Flash deprecation at the end of 2020, we have made a new solution available that replaces the Perfecto native automation commands clean device, reboot device, and get network settings. For details, see Deploy device maintenance scripts (Perfecto IDE alternative).

  • Command: device

  • Subcommand: clean

  • Supported Platforms: Native (legacy), Selenium

    All commands must be executed using the same framework. Sharing the execution ID between different frameworks is not possible. This means that if you work with a Selenium/Appium driver, you need to call the commands using the Selenium/Appium driver (or, in the case of Reporting commands, through the Reporting SDK that works with the driver) and not as part of a UFT test or another framework.

  • Supported OS: Android, iOS

Description

When a "deep clean" is selected, it removes all installed applications, all user data, and all installed files from the device. If the Clean Chrome parameter is selected, it resets the Chrome history on the device.

On iOS devices, this command only removes user-installed applications.

Parameters

Name

Value

Default

Description

deviceID*

    

The device for this command.

content

applications (Basic)

all (Deep)

bookmarks ()

calendar ()

messages ()

mms ()

Basic

Selects whether to perform 'basic' or 'deep' cleaning. Basic cleaning removes installed applications. Deep cleaning does the following:

  • Uninstalls the application

  • Resets the history in Google Chrome

  • Cleans user data: Google Chrome tabs and bookmarks, calendar, messages, MMS

* Mandatory parameter

Request & Response

Copy

Request

https://mycloud.perfectomobile.com/services/executions/john@perfectomobile.com_controller_16-11-02_12_21_16_829?operation=command&securityToken=<your_token>&command=device&subcommand=clean&param.deviceId=6370E775
Copy

JSON request

{
    "executionId":"john@perfectomobile.com_controller_16-11-02_12_21_16_829",
    "reason":"Success",
    "timer.elapsed":"20844",
    "testGridReportUrl":"https://mycloud.reporting-stg.perfectomobile.com?externalId[0]=john@perfectomobile.com_controller_16-11-02_12_21_16_829",
    "timer.ux":"0",
    "singleTestReportUrl":"https://mycloud.perfectomobile.com/nexperience/singletest/report/?reportRepositoryKey=PRIVATE:controller/161102/controller_16-11-02_12_21_16_829.xml&ownerId=john@perfectomobile.com&sharingCode=e967892e-5541-4b12-aa04-dc039ed8908f",
    "description":"Success",
    "timer.system":"20844",
    "reportKey":"PRIVATE:controller/161102/controller_16-11-02_12_21_16_829.xml",
    "completed":"true",
    "flowEndCode":"SUCCEEDED",
    "timer.device":"0"}