Android
android.test
public class

android.test.InstrumentationTestCase

java.lang.Object
junit.framework.Assert
junit.framework.TestCase Test
android.test.InstrumentationTestCase

A test case that has access to Instrumentation. See InstrumentationTestRunner.

Summary

Public Constructors

            InstrumentationTestCase()

Public Methods

          Instrumentation  getInstrumentation()
Inheritors can access the instrumentation using this.
          void  injectInsrumentation(Instrumentation instrumentation)
Injects instrumentation into this test case.
    final    <T extends Activity launchActivity(String pkg, Class<T> activityCls, Bundle extras)
Utility method for launching an activity.
          void  sendKeys(int[] keys)
Sends a series of key events through instrumentation and waits for idle.
          void  sendKeys(String keysSequence)
Sends a series of key events through instrumentation and waits for idle.
          void  sendRepeatedKeys(int[] keys)
Sends a series of key events through instrumentation and waits for idle.

Protected Methods

          void  runTest()
Runs the current unit test.
          void  tearDown()
Make sure all resources are cleaned up and garbage collected before moving on to the next test.
Methods inherited from class junit.framework.TestCase
Methods inherited from class junit.framework.Assert
Methods inherited from class java.lang.Object
Methods inherited from interface junit.framework.Test

Details

Public Constructors

public InstrumentationTestCase()

Public Methods

public Instrumentation getInstrumentation()

Inheritors can access the instrumentation using this.

Returns

  • instrumentation

public void injectInsrumentation(Instrumentation instrumentation)

Injects instrumentation into this test case. This method is called by the test runner during test setup.

Parameters

instrumentation the instrumentation to use with this instance

public final T launchActivity(String pkg, Class<T> activityCls, Bundle extras)

Utility method for launching an activity.

Parameters

pkg The package hosting the activity to be launched.
activityCls The activity class to launch.
extras Optional extra stuff to pass to the activity.

Returns

  • The activity, or null if non launched.

public void sendKeys(int[] keys)

Sends a series of key events through instrumentation and waits for idle. For instance: sendKeys(KEYCODE_DPAD_LEFT, KEYCODE_DPAD_CENTER).

Parameters

keys The series of key codes to send through instrumentation.

public void sendKeys(String keysSequence)

Sends a series of key events through instrumentation and waits for idle. The sequence of keys is a string containing the key names as specified in KeyEvent, without the KEYCODE_ prefix. For instance: sendKeys("DPAD_LEFT A B C DPAD_CENTER"). Each key can be repeated by using the N* prefix. For instance, to send two KEYCODE_DPAD_LEFT, use the following: sendKeys("2*DPAD_LEFT").

Parameters

keysSequence The sequence of keys.

public void sendRepeatedKeys(int[] keys)

Sends a series of key events through instrumentation and waits for idle. Each key code must be preceded by the number of times the key code must be sent. For instance: sendRepeatedKeys(1, KEYCODE_DPAD_CENTER, 2, KEYCODE_DPAD_LEFT).

Parameters

keys The series of key repeats and codes to send through instrumentation.

Protected Methods

protected void runTest()

Runs the current unit test. If the unit test is annotated with UiThreadTest, the test is run on the UI thread.

Throws

Throwable

protected void tearDown()

Make sure all resources are cleaned up and garbage collected before moving on to the next test. Subclasses that override this method should make sure they call super.tearDown() at the end of the overriding method.

Throws

Exception
Copyright 2007 Google Inc. Build 0.9_r1-98467 - 14 Aug 2008 18:56