Working With Mobile Screen Window

If your computer is connected to several mobile devices, emulators, or virtual machines, you can select the device or machine screen to be displayed in the Mobile Screen from the window toolbar:

This list is automatically updated when you connect or disconnect devices.

You can also click Select Device and specify the mobile device to which you want to connect in the resulting dialog.

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.

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.

This is not applicable to mobile applications to be run in the BitBar mobile device cloud. To learn how to launch them, see Connecting to Mobile Devices and Opening Testing Sessions.
This is applicable only to Android and iOS tested applications added to the Tested Applications collection of the current project and to be run on devices connected to the test workstation locally (legacy mobile support).

To launch a tested application, click Run Apps on the window toolbar and then select the desired application from the drop-down list.

Note: If the Deploy to the device on start parameter of the application in the Tested Application collection is enabled, TestComplete will install the application on the device first and then launch it.

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:

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

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).