AndroidTestCase

public class AndroidTestCase
extends TestCase

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


This class was deprecated in API level 24.
Use InstrumentationRegistry instead. New tests should be written using the Android Testing Support Library.

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

Returns the test context that was set via setTestContext(android.content.Context).

void setContext(Context context)
void setTestContext(Context context)

Test context can be used to access resources from the test's own package as opposed to the resources from the test target package.

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.

Inherited methods

Fields

mContext

Added in API level 1
protected Context mContext

Public constructors

AndroidTestCase

public AndroidTestCase ()

Public methods

assertActivityRequiresPermission

Added in API level 4
Deprecated in API level 24
public 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. 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 String: The package name of the activity to launch.

className String: The class of the activity to launch.

permission String: The name of the permission.

assertReadingContentUriRequiresPermission

Added in API level 4
Deprecated in API level 24
public 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.

Parameters
uri Uri: The uri that requires a permission to query.

permission String: The permission that should be required.

assertWritingContentUriRequiresPermission

Added in API level 4
Deprecated in API level 24
public 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.

Parameters
uri Uri: The uri that requires a permission to query.

permission String: The permission that should be required.

getContext

Added in API level 1
public Context getContext ()

Returns
Context

getTestContext

public Context getTestContext ()

Returns the test context that was set via setTestContext(android.content.Context).

Returns
Context

setContext

Added in API level 1
public void setContext (Context context)

Parameters
context Context

setTestContext

public void setTestContext (Context context)

Test context can be used to access resources from the test's own package as opposed to the resources from the test target package. Access to the latter is provided by the context set with the setContext(Context) method.

Parameters
context Context

testAndroidTestCaseSetupProperly

Added in API level 1
public void testAndroidTestCaseSetupProperly ()

Protected methods

scrubClass

Added in API level 1
protected void scrubClass (Class<?> testCaseClass)

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 Class: The class of the derived TestCase implementation.

Throws
java.lang.IllegalAccessException
IllegalAccessException

setUp

Added in API level 1
protected void setUp ()

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

Throws
Exception

tearDown

Added in API level 1
protected void tearDown ()

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

Throws
Exception