Recording Android Tests (Legacy)

Applies to TestComplete 15.63, last modified on April 10, 2024
The information below concerns legacy mobile tests that work with mobile devices connected to the local computer. For new mobile tests, we recommend using the newer cloud-compatible approach.

The easiest way to create Android tests is to record them. You can record tests in the Mobile Screen window. However, multi-touch gestures can be recorded on physical devices only.

If your Android application is instrumented, TestComplete records object-based tests. For unprepared applications, TestComplete records image-based tests.

Before Recording

  • Before recording an Android test for the first time, configure TestComplete, your Android device and (optionally but highly recommended) your Android application. For instructions, see Preparing for Testing Android Applications (Legacy).

  • Open the Mobile Screen window and connect to your device.

    If multiple devices are connected to TestComplete, select the needed device from the drop-down list at the top of the Mobile Screen window:

    Selecting mobile device for test recording
  • (For image-based tests) If you use Android 4.0-4.0.2, do something in the Mobile Screen window, for example, touch somewhere. This will ensure correct recording.

Recording Tests

  1. To start recording, do any of the following:

    • Click Record Keyword Test or Record Script on the Test Engine toolbar.

    • Select Test > Record > Record Keyword Test or Test > Record > Record Script from the TestComplete main menu.

    • Press Shift+F1 (the shortcut can be changed in the Global Shortcut Options).

    The Recording toolbar will appear on the screen.

  2. Perform test actions in the Mobile Screen window.


    • To record text input, click the text field in the Mobile Screen window and then enter text using your computer’s keyboard. See below.

    • To record pressing device buttons (Home, Back and others), click the corresponding buttons in the Mobile Screen’s footer. See Simulating Physical Button Events (Legacy).

    • To record a multi-touch gesture, click Record Gesture on the Mobile Screen toolbar and follow the onscreen instructions. See Recording Gestures (Multi-Touch Events) (Legacy).

  3. To stop recording, do any of the following:

TestComplete will open the recorded test in an editor, so that you can review and change it, if needed.

Sample recorded keyword test

Sample recorded script

Recording Text Input

Text input on a mobile device is usually made by using an onscreen keyboard. Currently, TestComplete is unable to record text input from the onscreen keyboard. To record test input, use the host computer's keyboard:

  • During test recording, select the appropriate text field in the Mobile Screen window.

  • Type the desired text using your computer’s keyboard.

TestComplete always records text input using the SetText action.


  • During test recording, TestComplete actively exchanges data with the tested Android application. If you are recording a test on a virtual machine, or on a physical Android device connected via Wi-Fi, the data goes through your local network. So, you might experience a slowdown when interacting with the tested application, especially if your local network is busy.

    For physical devices, a possible workaround is to use USB-connected devices for test recording, and to use Wi-Fi connections for test runs.

  • During recording, TestComplete captures images of the device screen and displays them in the Test Visualizer panel. These images help you understand what operations your test performs.

  • When recording white-box tests, TestComplete does not record user actions on disabled (grayed) Android controls. If you need your test to simulate such actions, create the corresponding test commands manually.

See Also

About Testing Android Applications (Legacy)
Creating Tests for White-Box Android Applications
Image-Based Testing in Android Applications (Legacy)
Simulating Basic Touch Actions Over Android Devices (Legacy)
Simulating User Actions Over Android Devices (Legacy)
Simulating Gestures (Multi-Touch Events) (Legacy)

Highlight search results