Mobile Screen Window

By default, the Mobile Screen window is hidden. To make it visible:

1. Connect to the mobile device. The way to do it depends on the platform of the target device and the technology used to connect to the device. For detailed instructions, see one of the following:

   Connecting to Mobile Devices and Opening Testing Sessions

   Preparing for Android Testing (Legacy Mobile Support)

   Preparing for iOS Testing (Legacy Mobile Support)

   Preparing for Xamarin.Forms Testing (Legacy Mobile Support)

2. Click the Show Mobile Screen button on the Test Engine toolbar:

   

   Click the image to enlarge it.

   Note: If the button is hidden, you can make it visible as it is described in Customizing Toolbars and Menus.

   In addition, TestComplete will show the Mobile Screen window automatically:

   • When you start the test recording and the Automatically display Mobile Screen when recording option is enabled.

   • When you call any Select On-Screen Object wizard and the Automatically display Mobile Screen on OnScreen operation option is enabled.

3. If there is only one mobile device connected to your computer, the Mobile Screen window will show the screen of the connected device. If there are several connected devices, TestComplete will open the Select Current Device dialog where you can select the target device.

The Mobile Screen window is used to record tests against mobile applications: TestComplete records only those actions that you perform in this window and ignores the actions that you perform on the device, emulator, or virtual machine.

The window toolbar let you control the window size, switch between connected devices and perform other test-related actions. See Mobile Screen Window Toolbar.

The window footer buttons emulate functionality of the device’s physical buttons. See Mobile Screen Window Footer.

Note: If you use the legacy mobile support, the Mobile Screen window also lets you start recording of multi-touch events. The latter must be recorded and simulated on devices that support a touch-sensitive interface.

For the detailed description of various recording and test-related tasks that you can perform in the window, see the following topic:

Working With Mobile Screen Window

Because the Mobile Screen window must be open to record tests for mobile applications, it is not affected by the Minimize TestComplete option. When you start recording, all TestComplete windows are minimized except for Mobile Screen.

For more information on mobile testing with TestComplete, see the following topics: