android.test
Class TouchUtils

java.lang.Object
  android.test.TouchUtils

public class TouchUtils
extends Object

Reusable methods for generating touch events. These methods can be used with InstrumentationTestCase or ActivityInstrumentationTestCase2 to simulate user interaction with the application through a touch screen.

Constructor Summary

TouchUtils()

Method Summary

static void	clickView(InstrumentationTestCase test, View v) Simulate touching the center of a view and releasing.
static void	drag(ActivityInstrumentationTestCase test, float fromX, float toX, float fromY, float toY, int stepCount) Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test
static void	drag(InstrumentationTestCase test, float fromX, float toX, float fromY, float toY, int stepCount) Simulate touching a specific location and dragging to a new location.
static void	dragQuarterScreenDown(ActivityInstrumentationTestCase test) Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test
static void	dragQuarterScreenDown(InstrumentationTestCase test, Activity activity) Simulate touching in the center of the screen and dragging one quarter of the way down
static void	dragQuarterScreenUp(ActivityInstrumentationTestCase test) Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test
static void	dragQuarterScreenUp(InstrumentationTestCase test, Activity activity) Simulate touching in the center of the screen and dragging one quarter of the way up
static int	dragViewBy(ActivityInstrumentationTestCase test, View v, int gravity, int deltaX, int deltaY) Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test
static int	dragViewBy(InstrumentationTestCase test, View v, int gravity, int deltaX, int deltaY) Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test
static int	dragViewTo(ActivityInstrumentationTestCase test, View v, int gravity, int toX, int toY) Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test
static int	dragViewTo(InstrumentationTestCase test, View v, int gravity, int toX, int toY) Simulate touching a view and dragging it to a specified location.
static void	dragViewToBottom(ActivityInstrumentationTestCase test, View v) Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test
static void	dragViewToBottom(ActivityInstrumentationTestCase test, View v, int stepCount) Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test
static void	dragViewToBottom(InstrumentationTestCase test, Activity activity, View v) Simulate touching the center of a view and dragging to the bottom of the screen.
static void	dragViewToBottom(InstrumentationTestCase test, Activity activity, View v, int stepCount) Simulate touching the center of a view and dragging to the bottom of the screen.
static void	dragViewToTop(ActivityInstrumentationTestCase test, View v) Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test
static void	dragViewToTop(ActivityInstrumentationTestCase test, View v, int stepCount) Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test
static void	dragViewToTop(InstrumentationTestCase test, View v) Simulate touching the center of a view and dragging to the top of the screen.
static void	dragViewToTop(InstrumentationTestCase test, View v, int stepCount) Simulate touching the center of a view and dragging to the top of the screen.
static int	dragViewToX(ActivityInstrumentationTestCase test, View v, int gravity, int toX) Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test
static int	dragViewToX(InstrumentationTestCase test, View v, int gravity, int toX) Simulate touching a view and dragging it to a specified location.
static int	dragViewToY(ActivityInstrumentationTestCase test, View v, int gravity, int toY) Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test
static int	dragViewToY(InstrumentationTestCase test, View v, int gravity, int toY) Simulate touching a view and dragging it to a specified location.
static void	longClickView(ActivityInstrumentationTestCase test, View v) Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test
static void	longClickView(InstrumentationTestCase test, View v) Simulate touching the center of a view, holding until it is a long press, and then releasing.
static void	scrollToBottom(ActivityInstrumentationTestCase test, ViewGroup v) Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test
static void	scrollToBottom(InstrumentationTestCase test, Activity activity, ViewGroup v) Scroll a ViewGroup to the bottom by repeatedly calling dragQuarterScreenUp(InstrumentationTestCase, Activity)
static void	scrollToTop(ActivityInstrumentationTestCase test, ViewGroup v) Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test
static void	scrollToTop(InstrumentationTestCase test, Activity activity, ViewGroup v) Scroll a ViewGroup to the top by repeatedly calling dragQuarterScreenDown(InstrumentationTestCase, Activity)
static void	tapView(InstrumentationTestCase test, View v) Simulate touching the center of a view and releasing quickly (before the tap timeout).
static void	touchAndCancelView(InstrumentationTestCase test, View v) Simulate touching the center of a view and cancelling (so no onClick should fire, etc).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TouchUtils

public TouchUtils()

Method Detail

dragQuarterScreenDown

@Deprecated
public static void dragQuarterScreenDown(ActivityInstrumentationTestCase test)

Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test

Simulate touching in the center of the screen and dragging one quarter of the way down

Parameters:

test - The test case that is being run

dragQuarterScreenDown

public static void dragQuarterScreenDown(InstrumentationTestCase test,
                                         Activity activity)

Simulate touching in the center of the screen and dragging one quarter of the way down

Parameters:

test - The test case that is being run

activity - The activity that is in the foreground of the test case

dragQuarterScreenUp

@Deprecated
public static void dragQuarterScreenUp(ActivityInstrumentationTestCase test)

Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test

Simulate touching in the center of the screen and dragging one quarter of the way up

Parameters:

test - The test case that is being run

dragQuarterScreenUp

public static void dragQuarterScreenUp(InstrumentationTestCase test,
                                       Activity activity)

Simulate touching in the center of the screen and dragging one quarter of the way up

Parameters:

test - The test case that is being run

activity - The activity that is in the foreground of the test case

scrollToBottom

@Deprecated
public static void scrollToBottom(ActivityInstrumentationTestCase test,
                                             ViewGroup v)

Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test

Scroll a ViewGroup to the bottom by repeatedly calling dragQuarterScreenUp(InstrumentationTestCase, Activity)

Parameters:

test - The test case that is being run

v - The ViewGroup that should be dragged

scrollToBottom

public static void scrollToBottom(InstrumentationTestCase test,
                                  Activity activity,
                                  ViewGroup v)

Scroll a ViewGroup to the bottom by repeatedly calling dragQuarterScreenUp(InstrumentationTestCase, Activity)

Parameters:

test - The test case that is being run

activity - The activity that is in the foreground of the test case

v - The ViewGroup that should be dragged

scrollToTop

@Deprecated
public static void scrollToTop(ActivityInstrumentationTestCase test,
                                          ViewGroup v)

Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test

Scroll a ViewGroup to the top by repeatedly calling dragQuarterScreenDown(InstrumentationTestCase, Activity)

Parameters:

test - The test case that is being run

v - The ViewGroup that should be dragged

scrollToTop

public static void scrollToTop(InstrumentationTestCase test,
                               Activity activity,
                               ViewGroup v)

Scroll a ViewGroup to the top by repeatedly calling dragQuarterScreenDown(InstrumentationTestCase, Activity)

Parameters:

test - The test case that is being run

activity - The activity that is in the foreground of the test case

v - The ViewGroup that should be dragged

dragViewToBottom

@Deprecated
public static void dragViewToBottom(ActivityInstrumentationTestCase test,
                                               View v)

Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test

Simulate touching the center of a view and dragging to the bottom of the screen.

Parameters:

test - The test case that is being run

v - The view that should be dragged

dragViewToBottom

public static void dragViewToBottom(InstrumentationTestCase test,
                                    Activity activity,
                                    View v)

Simulate touching the center of a view and dragging to the bottom of the screen.

Parameters:

test - The test case that is being run

activity - The activity that is in the foreground of the test case

v - The view that should be dragged

dragViewToBottom

@Deprecated
public static void dragViewToBottom(ActivityInstrumentationTestCase test,
                                               View v,
                                               int stepCount)

Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test

Simulate touching the center of a view and dragging to the bottom of the screen.

Parameters:

test - The test case that is being run

v - The view that should be dragged

stepCount - How many move steps to include in the drag

dragViewToBottom

public static void dragViewToBottom(InstrumentationTestCase test,
                                    Activity activity,
                                    View v,
                                    int stepCount)

Simulate touching the center of a view and dragging to the bottom of the screen.

Parameters:

test - The test case that is being run

activity - The activity that is in the foreground of the test case

v - The view that should be dragged

stepCount - How many move steps to include in the drag

tapView

public static void tapView(InstrumentationTestCase test,
                           View v)

Simulate touching the center of a view and releasing quickly (before the tap timeout).

Parameters:

test - The test case that is being run

v - The view that should be clicked

touchAndCancelView

public static void touchAndCancelView(InstrumentationTestCase test,
                                      View v)

Simulate touching the center of a view and cancelling (so no onClick should fire, etc).

Parameters:

test - The test case that is being run

v - The view that should be clicked

clickView

public static void clickView(InstrumentationTestCase test,
                             View v)

Simulate touching the center of a view and releasing.

Parameters:

test - The test case that is being run

v - The view that should be clicked

longClickView

@Deprecated
public static void longClickView(ActivityInstrumentationTestCase test,
                                            View v)

Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test

Simulate touching the center of a view, holding until it is a long press, and then releasing.

Parameters:

test - The test case that is being run

v - The view that should be clicked

longClickView

public static void longClickView(InstrumentationTestCase test,
                                 View v)

Simulate touching the center of a view, holding until it is a long press, and then releasing.

Parameters:

test - The test case that is being run

v - The view that should be clicked

dragViewToTop

@Deprecated
public static void dragViewToTop(ActivityInstrumentationTestCase test,
                                            View v)

Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test

Simulate touching the center of a view and dragging to the top of the screen.

Parameters:

test - The test case that is being run

v - The view that should be dragged

dragViewToTop

@Deprecated
public static void dragViewToTop(ActivityInstrumentationTestCase test,
                                            View v,
                                            int stepCount)

Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test

Simulate touching the center of a view and dragging to the top of the screen.

Parameters:

test - The test case that is being run

v - The view that should be dragged

stepCount - How many move steps to include in the drag

dragViewToTop

public static void dragViewToTop(InstrumentationTestCase test,
                                 View v)

Simulate touching the center of a view and dragging to the top of the screen.

Parameters:

test - The test case that is being run

v - The view that should be dragged

dragViewToTop

public static void dragViewToTop(InstrumentationTestCase test,
                                 View v,
                                 int stepCount)

Simulate touching the center of a view and dragging to the top of the screen.

Parameters:

test - The test case that is being run

v - The view that should be dragged

stepCount - How many move steps to include in the drag

dragViewBy

@Deprecated
public static int dragViewBy(ActivityInstrumentationTestCase test,
                                        View v,
                                        int gravity,
                                        int deltaX,
                                        int deltaY)

Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test

Simulate touching a view and dragging it by the specified amount.

Parameters:

test - The test case that is being run

v - The view that should be dragged

gravity - Which part of the view to use for the initial down event. A combination of (TOP, CENTER_VERTICAL, BOTTOM) and (LEFT, CENTER_HORIZONTAL, RIGHT)

deltaX - Amount to drag horizontally in pixels

deltaY - Amount to drag vertically in pixels

Returns:

distance in pixels covered by the drag

dragViewBy

public static int dragViewBy(InstrumentationTestCase test,
                             View v,
                             int gravity,
                             int deltaX,
                             int deltaY)

Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test

Simulate touching a view and dragging it by the specified amount.

Parameters:

test - The test case that is being run

v - The view that should be dragged

gravity - Which part of the view to use for the initial down event. A combination of (TOP, CENTER_VERTICAL, BOTTOM) and (LEFT, CENTER_HORIZONTAL, RIGHT)

deltaX - Amount to drag horizontally in pixels

deltaY - Amount to drag vertically in pixels

Returns:

distance in pixels covered by the drag

dragViewTo

@Deprecated
public static int dragViewTo(ActivityInstrumentationTestCase test,
                                        View v,
                                        int gravity,
                                        int toX,
                                        int toY)

Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test

Simulate touching a view and dragging it to a specified location.

Parameters:

test - The test case that is being run

v - The view that should be dragged

gravity - Which part of the view to use for the initial down event. A combination of (TOP, CENTER_VERTICAL, BOTTOM) and (LEFT, CENTER_HORIZONTAL, RIGHT)

toX - Final location of the view after dragging

toY - Final location of the view after dragging

Returns:

distance in pixels covered by the drag

dragViewTo

public static int dragViewTo(InstrumentationTestCase test,
                             View v,
                             int gravity,
                             int toX,
                             int toY)

Simulate touching a view and dragging it to a specified location.

Parameters:

test - The test case that is being run

v - The view that should be dragged

gravity - Which part of the view to use for the initial down event. A combination of (TOP, CENTER_VERTICAL, BOTTOM) and (LEFT, CENTER_HORIZONTAL, RIGHT)

toX - Final location of the view after dragging

toY - Final location of the view after dragging

Returns:

distance in pixels covered by the drag

dragViewToX

@Deprecated
public static int dragViewToX(ActivityInstrumentationTestCase test,
                                         View v,
                                         int gravity,
                                         int toX)

Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test

Simulate touching a view and dragging it to a specified location. Only moves horizontally.

Parameters:

test - The test case that is being run

v - The view that should be dragged

gravity - Which part of the view to use for the initial down event. A combination of (TOP, CENTER_VERTICAL, BOTTOM) and (LEFT, CENTER_HORIZONTAL, RIGHT)

toX - Final location of the view after dragging

Returns:

distance in pixels covered by the drag

dragViewToX

public static int dragViewToX(InstrumentationTestCase test,
                              View v,
                              int gravity,
                              int toX)

Simulate touching a view and dragging it to a specified location. Only moves horizontally.

Parameters:

test - The test case that is being run

v - The view that should be dragged

gravity - Which part of the view to use for the initial down event. A combination of (TOP, CENTER_VERTICAL, BOTTOM) and (LEFT, CENTER_HORIZONTAL, RIGHT)

toX - Final location of the view after dragging

Returns:

distance in pixels covered by the drag

dragViewToY

@Deprecated
public static int dragViewToY(ActivityInstrumentationTestCase test,
                                         View v,
                                         int gravity,
                                         int toY)

Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test

Simulate touching a view and dragging it to a specified location. Only moves vertically.

Parameters:

test - The test case that is being run

v - The view that should be dragged

gravity - Which part of the view to use for the initial down event. A combination of (TOP, CENTER_VERTICAL, BOTTOM) and (LEFT, CENTER_HORIZONTAL, RIGHT)

toY - Final location of the view after dragging

Returns:

distance in pixels covered by the drag

dragViewToY

public static int dragViewToY(InstrumentationTestCase test,
                              View v,
                              int gravity,
                              int toY)

Simulate touching a view and dragging it to a specified location. Only moves vertically.

Parameters:

test - The test case that is being run

v - The view that should be dragged

gravity - Which part of the view to use for the initial down event. A combination of (TOP, CENTER_VERTICAL, BOTTOM) and (LEFT, CENTER_HORIZONTAL, RIGHT)

toY - Final location of the view after dragging

Returns:

distance in pixels covered by the drag

drag

@Deprecated
public static void drag(ActivityInstrumentationTestCase test,
                                   float fromX,
                                   float toX,
                                   float fromY,
                                   float toY,
                                   int stepCount)

Deprecated. ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test

Simulate touching a specific location and dragging to a new location.

Parameters:

test - The test case that is being run

fromX - X coordinate of the initial touch, in screen coordinates

toX - Xcoordinate of the drag destination, in screen coordinates

fromY - X coordinate of the initial touch, in screen coordinates

toY - Y coordinate of the drag destination, in screen coordinates

stepCount - How many move steps to include in the drag

drag

public static void drag(InstrumentationTestCase test,
                        float fromX,
                        float toX,
                        float fromY,
                        float toY,
                        int stepCount)

Simulate touching a specific location and dragging to a new location.

Parameters:

test - The test case that is being run

fromX - X coordinate of the initial touch, in screen coordinates

toX - Xcoordinate of the drag destination, in screen coordinates

fromY - X coordinate of the initial touch, in screen coordinates

toY - Y coordinate of the drag destination, in screen coordinates

stepCount - How many move steps to include in the drag