Simulating Basic Touch Actions Over Android Open Applications (Legacy)

Basic Concepts

Simulating User Actions From Keyword Tests

Simulating User Actions From Scripts

If your Android application is Open, it exposes its controls, methods and properties to TestComplete. For all objects in Android Open Applications, TestComplete provides a number of specific properties and methods that let you simulate user actions over the controls.

To simulate basic Touch and Long press touch actions over controls in your tested Android applications, you can use the Touch and LongTouch methods TestComplete adds to all tested Android objects. Both these methods have the parameters that specify the control-related coordinates of the point where the touch is to be simulated. If these parameters are omitted, the touch action is simulated at the center of the control.

You can also simulate Drag actions over controls. A Drag action has the parameters that let you specify the coordinates where the initial touch will be simulated, as well as the horizontal and vertical distance of the drag.

Depending on the control’s class TestComplete also provides a set of object-specific methods you can use to simulate various touch actions. For example, for Android GridView controls, TestComplete provides the TouchCell and LongTouchCell methods you can use to simulate touch actions over individual cells of the control. For detailed information on how to simulate various actions over supported controls, see appropriate topics in the Working With Android Controls section.

To simulate touch actions over Android controls in keyword tests, call the Touch or LongTouch methods of the desired control with the needed parameters by using the On-Screen Action, Call Object Method, Run Code Snippet or Run Script Routine operations.

The image below demonstrates the On-Screen Action operation that calls the Touch method of the Android Button control to simulate a touch action at the point (10, 10) of the button:

To simulate touch actions over controls in scripts, call the appropriate Touch or LongTouch methods of the object that corresponds to the tested control.

The sample script code below demonstrates how to simulate a touch action within the button control at the point (10, 10):

def Test():
  Mobile.SetCurrent("MyDevice");
  # ...

  p = Mobile.Device("MyDevice").Process("smartbear.example.orders");
  button = p.RootLayout("").Layout("buttons_layout").Button("newButton");

  # Simualtes touching a button at the point (10, 10)
  button.Touch(10,10);