Added in API level 1
Deprecated in API level 24

AndroidTestCase

Kotlin |Java

open class AndroidTestCase : TestCase

kotlin.Any
↳	junit.framework.Assert
	↳	junit.framework.TestCase
		↳	android.test.AndroidTestCase

Known Direct Subclasses

ApplicationTestCase, LoaderTestCase, ProviderTestCase2, ServiceTestCase

ApplicationTestCase	This test case provides a framework in which you can test Application classes in a controlled environment.
LoaderTestCase	A convenience class for testing `Loader`s.
ProviderTestCase2	This test case class provides a framework for testing a single `ContentProvider` and for testing your app code with an isolated content provider.
ServiceTestCase	This test case provides a framework in which you can test Service classes in a controlled environment.

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

Summary

Public constructors
`<init>()`

Public methods
open Unit	`assertActivityRequiresPermission(packageName: String!, className: String!, permission: String!)` 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.
open Unit	`assertReadingContentUriRequiresPermission(uri: Uri!, permission: String!)` 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.
open Unit	`assertWritingContentUriRequiresPermission(uri: Uri!, permission: String!)` 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.
open Context!	`getContext()`
open Unit	`setContext(context: Context!)`
open Unit	`testAndroidTestCaseSetupProperly()`

Protected methods
open Unit	`scrubClass(testCaseClass: Class<*>!)` This function is called by various TestCase implementations, at tearDown() time, in order to scrub out any class variables.
open Unit	`setUp()`
open Unit	`tearDown()`

Inherited functions

From class Assert

`Unit`	`assertEquals(message: String!, expected: Any!, actual: Any!)` Asserts that two objects are equal. If they are not an AssertionFailedError is thrown with the given message.
`Unit`	`assertEquals(expected: Any!, actual: Any!)` Asserts that two objects are equal. If they are not an AssertionFailedError is thrown.
`Unit`	`assertEquals(message: String!, expected: String!, actual: String!)` Asserts that two Strings are equal.
`Unit`	`assertEquals(expected: String!, actual: String!)` Asserts that two Strings are equal.
`Unit`	`assertEquals(message: String!, expected: Double, actual: Double, delta: Double)` Asserts that two doubles are equal concerning a delta. If they are not an AssertionFailedError is thrown with the given message. If the expected value is infinity then the delta value is ignored.
`Unit`	`assertEquals(expected: Double, actual: Double, delta: Double)` Asserts that two doubles are equal concerning a delta. If the expected value is infinity then the delta value is ignored.
`Unit`	`assertEquals(message: String!, expected: Float, actual: Float, delta: Float)` Asserts that two floats are equal concerning a positive delta. If they are not an AssertionFailedError is thrown with the given message. If the expected value is infinity then the delta value is ignored.
`Unit`	`assertEquals(expected: Float, actual: Float, delta: Float)` Asserts that two floats are equal concerning a delta. If the expected value is infinity then the delta value is ignored.
`Unit`	`assertEquals(message: String!, expected: Long, actual: Long)` Asserts that two longs are equal. If they are not an AssertionFailedError is thrown with the given message.
`Unit`	`assertEquals(expected: Long, actual: Long)` Asserts that two longs are equal.
`Unit`	`assertEquals(message: String!, expected: Boolean, actual: Boolean)` Asserts that two booleans are equal. If they are not an AssertionFailedError is thrown with the given message.
`Unit`	`assertEquals(expected: Boolean, actual: Boolean)` Asserts that two booleans are equal.
`Unit`	`assertEquals(message: String!, expected: Byte, actual: Byte)` Asserts that two bytes are equal. If they are not an AssertionFailedError is thrown with the given message.
`Unit`	`assertEquals(expected: Byte, actual: Byte)` Asserts that two bytes are equal.
`Unit`	`assertEquals(message: String!, expected: Char, actual: Char)` Asserts that two chars are equal. If they are not an AssertionFailedError is thrown with the given message.
`Unit`	`assertEquals(expected: Char, actual: Char)` Asserts that two chars are equal.
`Unit`	`assertEquals(message: String!, expected: Short, actual: Short)` Asserts that two shorts are equal. If they are not an AssertionFailedError is thrown with the given message.
`Unit`	`assertEquals(expected: Short, actual: Short)` Asserts that two shorts are equal.
`Unit`	`assertEquals(message: String!, expected: Int, actual: Int)` Asserts that two ints are equal. If they are not an AssertionFailedError is thrown with the given message.
`Unit`	`assertEquals(expected: Int, actual: Int)` Asserts that two ints are equal.
`Unit`	`assertFalse(message: String!, condition: Boolean)` Asserts that a condition is false. If it isn't it throws an AssertionFailedError with the given message.
`Unit`	`assertFalse(condition: Boolean)` Asserts that a condition is false. If it isn't it throws an AssertionFailedError.
`Unit`	`assertNotNull(object: Any!)` Asserts that an object isn't null.
`Unit`	`assertNotNull(message: String!, object: Any!)` Asserts that an object isn't null. If it is an AssertionFailedError is thrown with the given message.
`Unit`	`assertNotSame(message: String!, expected: Any!, actual: Any!)` Asserts that two objects do not refer to the same object. If they do refer to the same object an AssertionFailedError is thrown with the given message.
`Unit`	`assertNotSame(expected: Any!, actual: Any!)` Asserts that two objects do not refer to the same object. If they do refer to the same object an AssertionFailedError is thrown.
`Unit`	`assertNull(object: Any!)` Asserts that an object is null. If it isn't an `AssertionError` is thrown. Message contains: Expected: but was: object
`Unit`	`assertNull(message: String!, object: Any!)` Asserts that an object is null. If it is not an AssertionFailedError is thrown with the given message.
`Unit`	`assertSame(message: String!, expected: Any!, actual: Any!)` Asserts that two objects refer to the same object. If they are not an AssertionFailedError is thrown with the given message.
`Unit`	`assertSame(expected: Any!, actual: Any!)` Asserts that two objects refer to the same object. If they are not the same an AssertionFailedError is thrown.
`Unit`	`assertTrue(message: String!, condition: Boolean)` Asserts that a condition is true. If it isn't it throws an AssertionFailedError with the given message.
`Unit`	`assertTrue(condition: Boolean)` Asserts that a condition is true. If it isn't it throws an AssertionFailedError.
`Unit`	`fail(message: String!)` Fails a test with the given message.
`Unit`	`fail()` Fails a test with no message.
`Unit`	`failNotEquals(message: String!, expected: Any!, actual: Any!)`
`Unit`	`failNotSame(message: String!, expected: Any!, actual: Any!)`
`Unit`	`failSame(message: String!)`
`String!`	`format(message: String!, expected: Any!, actual: Any!)`

From class 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.
`Unit`	`run(result: TestResult!)` Runs the test case and collects the results in TestResult.
`Unit`	`runBare()` Runs the bare test sequence.
`Unit`	`runTest()` Override to run the test and assert its state.
`Unit`	`setName(name: String!)` Sets the name of a TestCase
`String`	`toString()` Returns a string representation of the test case

Properties
Context!	`mContext`

Public constructors

<init>

AndroidTestCase()

Public methods

assertActivityRequiresPermission

Added in API level 4
Deprecated in API level 24

open fun assertActivityRequiresPermission(
    packageName: String!, 
    className: String!, 
    permission: String!
): Unit

Deprecated.

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

open fun assertReadingContentUriRequiresPermission(
    uri: Uri!, 
    permission: String!
): Unit

Deprecated.

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

open fun assertWritingContentUriRequiresPermission(
    uri: Uri!, 
    permission: String!
): Unit

Deprecated.

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
Deprecated in API level 24

open fun getContext(): Context!

Deprecated.

setContext

Added in API level 1
Deprecated in API level 24

open fun setContext(context: Context!): Unit

Deprecated.

testAndroidTestCaseSetupProperly

Added in API level 1
Deprecated in API level 24

open fun testAndroidTestCaseSetupProperly(): Unit

Deprecated.

Protected methods

scrubClass

Added in API level 1
Deprecated in API level 24

protected open fun scrubClass(testCaseClass: Class<*>!): Unit

Deprecated.

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.

Exceptions
`java.lang.IllegalAccessException`

setUp

Added in API level 1
Deprecated in API level 24

protected open fun setUp(): Unit

Deprecated.

tearDown

Added in API level 1
Deprecated in API level 24

protected open fun tearDown(): Unit

Deprecated.

Properties

mContext

Added in API level 1
Deprecated in API level 24

protected var mContext: Context!

Deprecated.