Description

The Device Loop operation is used to perform testing of mobile application on several connected mobile devices. It selects the mobile devices one after another and executes all child operations on each device.

Requirements

This operation is available only if you have a license for the TestComplete Mobile module.

Operation Result

The operation does not return any value.

Scripting Analogue

The actions that the operation performs are similar to calling the Mobile.SetCurrent() method in a loop. For more information, see Running Tests on Multiple Devices (Legacy).

Child Operations

The operation can have any other operation as a child (or children).

For information on how to make an operation a child of another operation, see the description of the Keyword Test editor’s Test Steps page.

Operation Parameters

When you add the operation to your keyword test, TestComplete displays a wizard that contains the following pages:

Select Loop Mode

On this page, you specify which devices will be involved:

To perform a test on all the devices that are available to TestComplete, select the Iterate Through All Connected Devices option.
To perform a mobile test on particular devices, choose the Iterate Through Specific Devices option.

Select Devices to Iterate Through

This page is shown if you selected Iterate Through Specific Devices on the “Select Loop Mode” page of the wizard. On this page, you define a list of devices to be used by the operation:

To add a device to the list, click Add. In the ensuing Add Device Loop Item wizard, you can select the name of the desired device.
To replace a previously added device with another one, or to modify device parameters, click Change and choose a new device.
To remove one of the previously added devices, press Remove.
To remove all the previously added devices, press Clear.

Once all the desired devices are defined for the operation, press Finish.

Modifying Parameters

After adding the operation to the test, you can modify the operation’s parameters via the same wizard you used to add the operation. To invoke the wizard, simply double-click the operation’s row in the Keyword Test editor.

Remarks

If the Device Loop operation is executed successfully, it makes the device, which was selected during iteration, the current device for the test. The Aliases.Device object will provide an interface to this device.
If any of the specified devices disconnects from the computer, the operation will fail.

Device Loop Operation