Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)

Summary: Ctors | Methods | Protected Methods | Inherited Methods | [Expand All]

Added in API level 3

public abstract class

ActivityInstrumentationTestCase2

extends ActivityTestCase

java.lang.Object
↳	junit.framework.Assert
	↳	junit.framework.TestCase
		↳	android.test.InstrumentationTestCase
			↳	android.test.ActivityTestCase
				↳	android.test.ActivityInstrumentationTestCase2<T extends android.app.Activity >

Class Overview

This class provides functional testing of a single activity. The activity under test will be created using the system infrastructure (by calling InstrumentationTestCase.launchActivity()) and you will then be able to manipulate your Activity directly.

Other options supported by this test case include:

You can run any test method on the UI thread (see UiThreadTest ).
You can inject custom Intents into your Activity (see setActivityIntent(Intent) ).

This class replaces ActivityInstrumentationTestCase , which is deprecated. New tests should be written using this base class.

If you prefer an isolated unit test, see ActivityUnitTestCase .

Developer Guides

For more information about application testing, read the Testing developer guide.

Summary

Public Constructors
	)">ActivityInstrumentationTestCase2 ( String pkg, Class <T> activityClass) This constructor was deprecated in API level 8. use `)">ActivityInstrumentationTestCase2(Class)` instead
	)">ActivityInstrumentationTestCase2 ( Class <T> activityClass) Creates an `ActivityInstrumentationTestCase2` .

Public Methods
T	getActivity () Get the Activity under test, starting it if necessary.
void	setActivityInitialTouchMode (boolean initialTouchMode) Call this method before the first call to `getActivity()` to set the initial touch mode for the Activity under test.
void	setActivityIntent ( Intent i) Call this method before the first call to `getActivity()` to inject a customized Intent into the Activity under test.

Protected Methods
void	runTest () Runs the current unit test.
void	setUp () Sets up the fixture, for example, open a network connection.
void	tearDown () Make sure all resources are cleaned up and garbage collected before moving on to the next test.

[Expand]

Inherited Methods

From class android.test.ActivityTestCase

From class android.test.InstrumentationTestCase

From class junit.framework.TestCase

int	countTestCases () Counts the number of test cases executed by run(TestResult result).
TestResult	createResult () Creates a default TestResult object
String	getName () Gets the name of a TestCase
TestResult	run () A convenience method to run this test, collecting the results with a default TestResult object.
void	run ( TestResult result) Runs the test case and collects the results in TestResult.
void	runBare () Runs the bare test sequence.
void	runTest () Override to run the test and assert its state.
void	setName ( String name) Sets the name of a TestCase
void	setUp () Sets up the fixture, for example, open a network connection.
void	tearDown () Tears down the fixture, for example, close a network connection.
String	toString () Returns a string representation of the test case

From class junit.framework.Assert

static void	assertEquals (short expected, short actual) Asserts that two shorts are equal.
static void	assertEquals ( String message, int expected, int actual) Asserts that two ints are equal.
static void	assertEquals ( String message, short expected, short actual) Asserts that two shorts are equal.
static void	assertEquals (char expected, char actual) Asserts that two chars are equal.
static void	assertEquals ( String message, String expected, String actual) Asserts that two Strings are equal.
static void	assertEquals (int expected, int actual) Asserts that two ints are equal.
static void	assertEquals ( String message, double expected, double actual, double delta) Asserts that two doubles are equal concerning a delta.
static void	assertEquals ( String message, long expected, long actual) Asserts that two longs are equal.
static void	assertEquals (byte expected, byte actual) Asserts that two bytes are equal.
static void	assertEquals ( Object expected, Object actual) Asserts that two objects are equal.
static void	assertEquals (boolean expected, boolean actual) Asserts that two booleans are equal.
static void	assertEquals ( String message, float expected, float actual, float delta) Asserts that two floats are equal concerning a positive delta.
static void	assertEquals ( String message, boolean expected, boolean actual) Asserts that two booleans are equal.
static void	assertEquals ( String expected, String actual) Asserts that two Strings are equal.
static void	assertEquals (float expected, float actual, float delta) Asserts that two floats are equal concerning a delta.
static void	assertEquals ( String message, byte expected, byte actual) Asserts that two bytes are equal.
static void	assertEquals (double expected, double actual, double delta) Asserts that two doubles are equal concerning a delta.
static void	assertEquals ( String message, char expected, char actual) Asserts that two chars are equal.
static void	assertEquals ( String message, Object expected, Object actual) Asserts that two objects are equal.
static void	assertEquals (long expected, long actual) Asserts that two longs are equal.
static void	assertFalse ( String message, boolean condition) Asserts that a condition is false.
static void	assertFalse (boolean condition) Asserts that a condition is false.
static void	assertNotNull ( String message, Object object) Asserts that an object isn't null.
static void	assertNotNull ( Object object) Asserts that an object isn't null.
static void	assertNotSame ( Object expected, Object actual) Asserts that two objects do not refer to the same object.
static void	assertNotSame ( String message, Object expected, Object actual) Asserts that two objects do not refer to the same object.
static void	assertNull ( Object object) Asserts that an object is null.
static void	assertNull ( String message, Object object) Asserts that an object is null.
static void	assertSame ( Object expected, Object actual) Asserts that two objects refer to the same object.
static void	assertSame ( String message, Object expected, Object actual) Asserts that two objects refer to the same object.
static void	assertTrue ( String message, boolean condition) Asserts that a condition is true.
static void	assertTrue (boolean condition) Asserts that a condition is true.
static void	fail ( String message) Fails a test with the given message.
static void	fail () Fails a test with no message.
static void	failNotEquals ( String message, Object expected, Object actual)
static void	failNotSame ( String message, Object expected, Object actual)
static void	failSame ( String message)
static String	format ( String message, Object expected, Object actual)

From class java.lang.Object

Object	clone () Creates and returns a copy of this `Object` .
boolean	equals ( Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize () Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class <?>	getClass () Returns the unique instance of `Class` that represents this object's class.
int	hashCode () Returns an integer hash code for this object.
final void	notify () Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll () Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString () Returns a string containing a concise, human-readable description of this object.
final void	wait () Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait (long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait (long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

From interface junit.framework.Test

Public Constructors

)">

public ActivityInstrumentationTestCase2 ( String pkg, Class <T> activityClass)

Added in API level 3

This constructor was deprecated in API level 8.
use )">ActivityInstrumentationTestCase2(Class) instead

Creates an ActivityInstrumentationTestCase2 .

Parameters

pkg	ignored - no longer in use.
activityClass	The activity to test. This must be a class in the instrumentation targetPackage specified in the AndroidManifest.xml

)">

public ActivityInstrumentationTestCase2 ( Class <T> activityClass)

Added in API level 8

Creates an ActivityInstrumentationTestCase2 .

Parameters

activityClass	The activity to test. This must be a class in the instrumentation targetPackage specified in the AndroidManifest.xml

Public Methods

public T getActivity ()

Added in API level 3

Get the Activity under test, starting it if necessary. For each test method invocation, the Activity will not actually be created until the first time this method is called.

If you wish to provide custom setup values to your Activity, you may call setActivityIntent(Intent) and/or setActivityInitialTouchMode(boolean) before your first call to getActivity(). Calling them after your Activity has started will have no effect.

NOTE: Activities under test may not be started from within the UI thread. If your test method is annotated with UiThreadTest , then your Activity will be started automatically just before your test method is run. You still call this method in order to get the Activity under test.

Returns

the Activity under test

public void setActivityInitialTouchMode (boolean initialTouchMode)

Added in API level 3

Call this method before the first call to getActivity() to set the initial touch mode for the Activity under test.

If you do not call this, the touch mode will be false. If you call this after your Activity has been started, it will have no effect.

NOTE: Activities under test may not be started from within the UI thread. If your test method is annotated with UiThreadTest , then you must call setActivityInitialTouchMode(boolean) from setUp() .

Parameters

initialTouchMode	true if the Activity should be placed into "touch mode" when started

public void setActivityIntent ( Intent i)

Added in API level 3

Call this method before the first call to getActivity() to inject a customized Intent into the Activity under test.

If you do not call this, the default intent will be provided. If you call this after your Activity has been started, it will have no effect.

NOTE: Activities under test may not be started from within the UI thread. If your test method is annotated with UiThreadTest , then you must call setActivityIntent(Intent) from setUp() .

The default Intent (if this method is not called) is: action = ACTION_MAIN flags = FLAG_ACTIVITY_NEW_TASK All other fields are null or empty.

Parameters

i	The Intent to start the Activity with, or null to reset to the default Intent.

Protected Methods

protected void runTest ()

Added in API level 3

Runs the current unit test. If the unit test is annotated with UiThreadTest , force the Activity to be created before switching to the UI thread.

Throws

Throwable

protected void setUp ()

Added in API level 3

Sets up the fixture, for example, open a network connection. This method is called before a test is executed.

Throws

Exception

protected void tearDown ()

Added in API level 3

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

Results

Interfaces

Classes

Errors

ActivityInstrumentationTestCase2

Class Overview

Developer Guides

Summary

Public Constructors

public ActivityInstrumentationTestCase2 ( String pkg, Class <T> activityClass)

Parameters

public ActivityInstrumentationTestCase2 ( Class <T> activityClass)

Parameters

Public Methods

public T getActivity ()

Returns

public void setActivityInitialTouchMode (boolean initialTouchMode)

Parameters

public void setActivityIntent ( Intent i)

Parameters

Protected Methods

protected void runTest ()

Throws

protected void setUp ()

Throws

protected void tearDown ()

Throws