Simulating Basic Touch Actions Over Android Devices

Basic Concepts

Simulating Touch Actions in Keyword Tests

Simulating Touch Actions in Scripts

Simulating Custom Actions

To access your mobile devices (real or virtual) from tests, you use the Device object. For the object, TestComplete provides a number of methods you can use to simulate various actions over your device:

• Touch actions - Every object in Android applications can be touched (or “clicked”). You can perform a touch action at specific screen coordinates by calling the Touch method.

• Long press actions - Long press actions enable the data selection mode. TestComplete provides a TouchAndHold method you can use to long press at specific screen coordinates.

• Double-touch actions - To perform double-touch actions at specific screen coordinates in Android applications, use the DoubleTouch method.

• Swipe actions - Swipe actions are used to scroll through the content or navigate between screens, windows and views. To perform a swipe action, you can call the Swipe method.

• Drag actions - Drag actions are used to move items within containers. To perform a drag action, you can use the Drag method.

• Other touch actions - The Pinch close and Pinch open actions, as well as any other types of touch actions, can be recorded and simulated as gestures. For detailed information on recording gestures, see Recording Gestures (Multi-Touch Events).

• Actions over physical buttons - To simulate pressing device buttons (Home, Back, and others), see Simulating Physical Button Events.

To simulate a touch at specific screen coordinates from keyword tests, use the Device Touch operation:

To simulate long press, swipe and drag actions in keyword tests, call the appropriate methods of the Device object by using the Call Object Method, Run Code Snippet or Run Script Routine operations.

To touch at specific screen coordinates from scripts, use the Device.Touch method.

To perform a long press at specific screen coordinates for the specified period of time, use the Device.TouchAndHold method.

To perform a double touch at specific screen coordinates from scripts, use the Device.DoubleTouch method.

Use the Device.Swipe scripting method to simulate swipe actions from your scripts.

Use the Device.Drag scripting method to simulate dragging in your scripts.

In your tests, you may need to simulate arbitrary actions that cannot be performed with any of the methods and operations described above. For example, you may need to "draw" a custom shape on the device’s screen with a fingertip.

You can simulate custom actions using the following TestComplete scripting methods:

• Device.TouchPress
• Device.Move
• Device.TouchRelease
• Delay

Using these methods, you can create custom actions or simulate standard actions, such as Drag, Touch, Long Press and others.

Below are some script examples that demonstrate how to use these methods to simulate Android actions. If you want to simulate these actions from keyword tests, use the Run Code Snippet operation or create several Call Object Method operations that invoke the needed methods one after another.

• Example 1

  To simulate a custom drag action, call the Device.TouchPress and Device.TouchRelease methods one after another. Emulate the Press event at the current position of the item to be dragged, and then call the Release event at the destination coordinates.

  JavaScript, JScript

  Python

  VBScript

  DelphiScript

  C++Script, C#Script

  JavaScript, JScript

  Mobile.Device().TouchPress(50, 70);
  Mobile.Device().TouchRelease(300, 150);

  Python

  Mobile.Device().TouchPress(50, 70)
  Mobile.Device().TouchRelease(300, 150)

  VBScript

  Call Mobile.Device.TouchPress(50, 70)
  Call Mobile.Device.TouchRelease(300, 150)

  DelphiScript

  Mobile.Device.TouchPress(50, 70);
  Mobile.Device.TouchRelease(300, 150);

  C++Script, C#Script

  Mobile["Device"]["TouchPress"](50, 70);
  Mobile["Device"]["TouchRelease"](300, 150);

  Note that the X and Y parameters of the TouchPress and TouchRelease methods are dissimilar.

• Example 2

  To simulate custom long press actions, call the Device.TouchPress, Delay and Device.TouchRelease scripting methods one after another.

  JavaScript, JScript

  Python

  VBScript

  DelphiScript

  C++Script, C#Script

  JavaScript, JScript

  Mobile.Device().TouchPress(250, 270);
  Delay(200);
  Mobile.Device().TouchRelease(250, 270);

  Python

  Mobile.Device().TouchPress(250, 270)
  Delay(200)
  Mobile.Device().TouchRelease(250, 270)

  VBScript

  Call Mobile.Device.TouchPress(250, 270)
  Call Delay(200)
  Call Mobile.Device.TouchRelease(250, 270)

  DelphiScript

  Mobile.Device.TouchPress(250, 270);
  Delay(200);
  Mobile.Device.TouchRelease(250, 270);

  C++Script, C#Script

  Mobile["Device"]["TouchPress"](250, 270);
  Delay(200);
  Mobile["Device"]["TouchRelease"](250, 270);

  Note that the TouchPress() and TouchRelease() methods should have the same values of the X and Y parameters.

• Example 3

  To simulate custom shape actions, call Device.TouchPress, several Device.Move methods and then Device.TouchRelease.

  JavaScript, JScript

  Python

  VBScript

  DelphiScript

  C++Script, C#Script

  JavaScript, JScript

  Mobile.Device().TouchPress(250, 270);
  Mobile.Device().Move(270, 270);
  Mobile.Device().Move(290, 290);
  Mobile.Device().Move(240, 240);
  Mobile.Device().TouchRelease(240, 240);

  Python

  Mobile.Device().TouchPress(250, 270)
  Mobile.Device().Move(270, 270)
  Mobile.Device().Move(290, 290)
  Mobile.Device().Move(240, 240)
  Mobile.Device().TouchRelease(240, 240)

  VBScript

  Call Mobile.Device.TouchPress(250, 270)
  Call Mobile.Device.Move(270, 270)
  Call Mobile.Device.Move(290, 290)
  Call Mobile.Device.Move(240, 240)
  Call Mobile.Device.TouchRelease(240, 240)

  DelphiScript

  Mobile.Device.TouchPress(250, 270);
  Mobile.Device.Move(270, 270);
  Mobile.Device.Move(290, 290);
  Mobile.Device.Move(240, 240);
  Mobile.Device.TouchRelease(240, 240);

  C++Script, C#Script

  Mobile["Device"]["TouchPress"](250, 270);
  Mobile["Device"]["Move"](270, 270);
  Mobile["Device"]["Move"](290, 290);
  Mobile["Device"]["Move"](240, 240);
  Mobile["Device"]["TouchRelease"](240, 240);