About Gestures (Legacy)

Applies to TestComplete 15.69, last modified on November 13, 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.

User actions in mobile applications can be recorded by TestComplete as scripts, as keyword tests and as gestures. The latter is a mobile-specific type of tests intended for recording and simulating multi-touch actions.

TestComplete provides the AndroidGestureCollection project item for managing multi-touch actions. A project can contain only one AndroidGestureCollection item, however, each AndroidGestureCollection item may contain several gesture collections, and each collection can hold one or more gestures. Gestures can be added to and removed form collections as well gesture collections can be added to and removed form TestComplete projects. For more information on adding and removing project items, see Adding and Removing Project Items and Their Child Elements.

  • Any gesture can include several simultaneous touch actions. The exact number of recognized simultaneous touch actions depends on the device.

  • Gestures are recorded and simulated relative to screen coordinates. However, the gesture coordinates are scaled depending on the screen resolution of the current mobile device. That is, a gesture can be recorded on one device and played back on another device.

  • Gestures are recorded and simulated only on devices that support a touch-sensitive interface. Usually, these are hardware devices. Gestures cannot be recorded or played back on virtual machines and emulators, unless they support a touch-sensitive interface.

    To learn how to record gestures, see the Recording Gestures (Multi-Touch Events) (Legacy) topic.

  • Gestures and gesture collections can be managed and reviewed in the Gestures editor.

  • By default, touch actions are played back at a slower speed than they were recorded. This is done to make touch actions more accurate. In the Gestures editor, you can adjust the Playback acceleration parameter of a gesture. However, keep in mind that the faster the speed, the lower the precision.
  • Once recorded, a gesture can be played back as a test item, or it can be called from a keyword test or script. To learn how to execute gestures, see Executing Gestures (Multi-Touch Events) (Legacy).

See Also

About Testing Android Applications (Legacy)

Highlight search results