Page tree
Skip to end of metadata
Go to start of metadata

Release(DeviceName, ReleaseAgent, RemoveFromDeviceList, ReleaseFromCloud)

Supported in iOS Supported in Android


This command gives the user several options on how to automate several common scenarios when finished testing on a specific device. The option to release the execution port is closely related to the Executor Add-On feature.

Note: For more about the executor add-on - Click here.


  • DeviceNameThe name of the device you wish to release.
  • Special cases:
    • "" = The active device will be released
    • "*" = all devices that were locked by the user will be released (in case of serial execution)
  • ReleaseAgentDeprecated Boolean parameter. If set to true or false will release the execution agent the device was using.
  • RemoveFromDeviceListBoolean parameter. If set to true, will remove the device from the connected devices menu.
  • ReleaseFromCloudBoolean parameter. If set to true, will release the device from the current user in the Cloud.


We will use this command to release the tested device.


  • DeviceName: “adb:Galaxy Tab”
  • ReleaseAgent: True
  • RemoveFromDeviceList: True
  • ReleaseFromCloud: True


Device will be released from the cloud. Also it will be removed from the device list as well. The agent which was being used will also freed.

Code Examples

Java Example
client.releaseDevice("adb:Galaxy Tab", true, true, true);
C# Example
client.ReleaseDevice("adb:Galaxy Tab", true, true, true);
VBScript Example
client.ReleaseDevice "adb:Galaxy Tab", true, true, true
Python Example
self.client.releaseDevice("adb:Galaxy Tab", True, True, True)
Perl Example
$client->releaseDevice("adb:Galaxy Tab", 1, 1, 1);
  • No labels