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

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.

Summary

Public Constructors
	ActivityInstrumentationTestCase2(String pkg, Class<T> activityClass) NOTE: The parameter pkg must refer to the package identifier of the package hosting the activity to be launched, which is specified in the AndroidManifest.xml file.

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

Instrumentation	getInstrumentation() Inheritors can access the instrumentation using this.
void	injectInsrumentation(Instrumentation instrumentation) Injects instrumentation into this test case.
final <T extends Activity> T	launchActivity(String pkg, Class<T> activityCls, Bundle extras) Utility method for launching an activity.
final <T extends Activity> T	launchActivityWithIntent(String pkg, Class<T> activityCls, Intent intent) Utility method for launching an activity with a specific Intent.
void	runTest() Runs the current unit test.
void	runTestOnUiThread(Runnable r) Helper for running portions of a test on the UI thread.
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.
void	tearDown() Make sure all resources are cleaned up and garbage collected before moving on to the next test.

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
void	run(TestResult result) Runs the test case and collects the results in TestResult.
TestResult	run() A convenience method to run this test, collecting the results with a default TestResult object.
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(long expected, long actual) Asserts that two longs are equal.
static void	assertEquals(String message, byte expected, byte actual) Asserts that two bytes are equal.
static void	assertEquals(String message, short expected, short actual) Asserts that two shorts are equal.
static void	assertEquals(boolean expected, boolean actual) Asserts that two booleans are equal.
static void	assertEquals(String message, char expected, char actual) Asserts that two chars are equal.
static void	assertEquals(String message, float expected, float actual, float delta) Asserts that two floats are equal concerning a delta.
static void	assertEquals(String message, double expected, double actual, double delta) Asserts that two doubles are equal concerning a delta.
static void	assertEquals(byte expected, byte actual) Asserts that two bytes are equal.
static void	assertEquals(String message, String expected, String actual) Asserts that two Strings 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, long expected, long actual) Asserts that two longs are equal.
static void	assertEquals(String message, int expected, int actual) Asserts that two ints are equal.
static void	assertEquals(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(Object expected, Object actual) Asserts that two objects are equal.
static void	assertEquals(short expected, short actual) Asserts that two shorts are equal.
static void	assertEquals(float expected, float actual, float delta) Asserts that two floats are equal concerning a delta.
static void	assertEquals(int expected, int actual) Asserts that two ints are equal.
static void	assertEquals(String expected, String actual) Asserts that two Strings are equal.
static void	assertEquals(String message, boolean expected, boolean actual) Asserts that two booleans are equal.
static void	assertFalse(boolean condition) Asserts that a condition is false.
static void	assertFalse(String message, 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 refer to the same object.
static void	assertNotSame(String message, Object expected, Object actual) Asserts that two objects refer to the same object.
static void	assertNull(String message, Object object) Asserts that an object is null.
static void	assertNull(Object object) Asserts that an object is null.
static void	assertSame(String message, Object expected, Object actual) Asserts that two objects refer to the same object.
static void	assertSame(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() Fails a test with no message.
static void	fail(String message) Fails a test with the given message.

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() Is called before the object's memory is being reclaimed by the VM.
final Class<? extends Object>	getClass() Returns the unique instance of Class which 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(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.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.

From interface junit.framework.Test

Public Constructors

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

NOTE: The parameter pkg must refer to the package identifier of the package hosting the activity to be launched, which is specified in the AndroidManifest.xml file. This is not necessarily the same as the java package name.

Parameters

pkg	The package hosting the activity to be launched.
activityClass	The activity to test.

Public Methods

public T getActivity ()

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)

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)

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 ()

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 ()

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

Throws

Exception

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

Interfaces

Classes

Errors

ActivityInstrumentationTestCase2

Class Overview

Summary

Public Constructors

public ActivityInstrumentationTestCase2 (String pkg, 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