Working With Mobile Screen Window

To restart the application running on the device and return the application to its initial state, click Restart application on the window toolbar.

On iOS devices, it is available only if the bundleId of the application has been specified upon opening a testing session.

To reconnect to the device to which TestComplete has been connected last and to re-open a testing session on that device, click Reconnect on the window toolbar.

To close a testing session on the connected device and to disconnect from it, click Disconnect on the device toolbar.

Using TestComplete, you can also record and play back multi-touch gestures.

You can record gestures only on physical devices. For more information, see Recording Gestures (Multi-Touch Events) (Legacy).

1. Click Record Gesture on the Mobile Screen’s toolbar. This will open the Add Gesture dialog.

2. Enter the gesture name and select a collection to save it to.

3. Perform a gesture on your physical device.

4. Press the Stop Recording button in the Add Gesture dialog.

TestComplete will add the recorded gesture to the Android Gesture collection of your test project.

1. Click Select Gesture on the Mobile Screen’s toolbar.

2. Select the gesture in the Select Gesture to Run dialog and click Run.

TestComplete will perform the gesture on the connected Android device.

To add a new image to the Image Repository collection:

1. Click the Add Image toolbar item.

2. TestComplete will open the Add Image to Image Repository wizard.

3. On the Select the region from the picture page of the wizard, select the needed region.

4. On the further pages of the wizard, specify the name for the new item and select the image set to which it will be added.

5. Click Finish to add the image to Image Repository.

Click Take Screenshot on the Mobile Screen’s toolbar and specify the file name and location where the image file will be created.

Note: You can send the captured screenshots to your colleagues to demonstrate an issue, or use them for some other purposes. However, you cannot use them in your image-based tests, as TestComplete captures these images with lossy compression. For information on capturing images for image-based tests, see above.

TestComplete Android Agent is a helper utility that facilitates data exchange between TestComplete and the mobile device. To install the Agent on the connected device, click the Install Android Agent toolbar item. The Agent will be deployed and launched on the device.

To emulate pressing physical buttons of the device, use the buttons shown at the Mobile Screen’s footer:

• Back

• Home

• Settings (Recents)

• Volume Down

• Volume Up

• On/Off (available only for Android devices managed either by a private Appium server, or connected to the computer locally)

To learn how to emulate other types of physical buttons, see Simulating Physical Button Events (Legacy).

To check how your tested application’s layout looks and functions depending on the device screen orientation, click Change orientation on the window toolbar.

You can rotate the image in the Mobile Screen by using the Rotate Left and Rotate Right buttons. This is useful if the image is in a wrong orientation (this may see this with some Android devices).

To change the zoom level:

• Click the Zoom toolbar item and use the track bar to set the desired zoom level.

  You can click Best Size to fit the device screen picture into the maximal size of the Mobile Screen.

– or –

• Resize the Mobile Screen. TestComplete will change the zoom appropriately.