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)

Added in API level 1

public class

AndroidTestCase

extends TestCase

java.lang.Object
↳	junit.framework.Assert
	↳	junit.framework.TestCase
		↳	android.test.AndroidTestCase

Known Direct Subclasses

ApplicationTestCase <T extends Application >, LoaderTestCase , ProviderTestCase2 <T extends ContentProvider >, ScrollerCompatTestBase , ServiceTestCase <T extends Service >

Known Indirect Subclasses

DonutScrollerCompatTest , GingerbreadScrollerCompatTest , IcsScrollerCompatTest

Class Overview

Extend this if you need to access Resources or other things that depend on Activity Context.

Summary

Fields
protected Context	mContext

Public Constructors
	AndroidTestCase ()

Public Methods
void	assertActivityRequiresPermission ( String packageName, String className, String permission) Asserts that launching a given activity is protected by a particular permission by attempting to start the activity and validating that a `SecurityException` is thrown that mentions the permission in its error message.
void	assertReadingContentUriRequiresPermission ( Uri uri, String permission) Asserts that reading from the content uri requires a particular permission by querying the uri and ensuring a `SecurityException` is thrown mentioning the particular permission.
void	assertWritingContentUriRequiresPermission ( Uri uri, String permission) Asserts that writing to the content uri requires a particular permission by inserting into the uri and ensuring a `SecurityException` is thrown mentioning the particular permission.
Context	getContext ()
void	setContext ( Context context)
void	testAndroidTestCaseSetupProperly ()

Protected Methods
void	)">scrubClass ( Class <?> testCaseClass) This function is called by various TestCase implementations, at tearDown() time, in order to scrub out any class variables.
void	setUp () Sets up the fixture, for example, open a network connection.
void	tearDown () Tears down the fixture, for example, close a network connection.

[Expand]

Inherited Methods

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

Fields

protected Context mContext

Added in API level 1

Public Constructors

public AndroidTestCase ()

Added in API level 1

Public Methods

public void assertActivityRequiresPermission ( String packageName, String className, String permission)

Added in API level 4

Asserts that launching a given activity is protected by a particular permission by attempting to start the activity and validating that a SecurityException is thrown that mentions the permission in its error message. Note that an instrumentation isn't needed because all we are looking for is a security error and we don't need to wait for the activity to launch and get a handle to the activity.

Parameters

packageName	The package name of the activity to launch.
className	The class of the activity to launch.
permission	The name of the permission.

public void assertReadingContentUriRequiresPermission ( Uri uri, String permission)

Added in API level 4

Asserts that reading from the content uri requires a particular permission by querying the uri and ensuring a SecurityException is thrown mentioning the particular permission.

Parameters

uri	The uri that requires a permission to query.
permission	The permission that should be required.

public void assertWritingContentUriRequiresPermission ( Uri uri, String permission)

Added in API level 4

Asserts that writing to the content uri requires a particular permission by inserting into the uri and ensuring a SecurityException is thrown mentioning the particular permission.

Parameters

uri	The uri that requires a permission to query.
permission	The permission that should be required.

public Context getContext ()

Added in API level 1

public void setContext ( Context context)

Added in API level 1

public void testAndroidTestCaseSetupProperly ()

Added in API level 1

Protected Methods

)">

protected void scrubClass ( Class <?> testCaseClass)

Added in API level 1

This function is called by various TestCase implementations, at tearDown() time, in order to scrub out any class variables. This protects against memory leaks in the case where a test case creates a non-static inner class (thus referencing the test case) and gives it to someone else to hold onto.

Parameters

testCaseClass	The class of the derived TestCase implementation.

Throws

IllegalAccessException

protected void setUp ()

Added in API level 1

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 1

Tears down the fixture, for example, close a network connection. This method is called after a test is executed.

Throws

Exception

Results

Interfaces

Classes

Errors

AndroidTestCase

Class Overview

Summary

Fields

protected Context mContext

Public Constructors

public AndroidTestCase ()

Public Methods

public void assertActivityRequiresPermission ( String packageName, String className, String permission)

Parameters

public void assertReadingContentUriRequiresPermission ( Uri uri, String permission)

Parameters

public void assertWritingContentUriRequiresPermission ( Uri uri, String permission)

Parameters

public Context getContext ()

public void setContext ( Context context)

public void testAndroidTestCaseSetupProperly ()

Protected Methods

protected void scrubClass ( Class <?> testCaseClass)

Parameters

Throws

protected void setUp ()

Throws

protected void tearDown ()

Throws