Added in API level 1
Deprecated in API level 24

AndroidTestCase


open class AndroidTestCase
kotlin.Any
   ↳ android.test.AndroidTestCase

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

Summary

Public constructors

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

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

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!

open Context!

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

open Unit
setContext(context: Context!)

open Unit

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

open Unit

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

open Unit

Properties
Context!

Public constructors

AndroidTestCase

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: Deprecated in Java.

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: Deprecated in Java.

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: Deprecated in Java.

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
open fun getContext(): Context!

Deprecated: Deprecated in Java.

getTestContext

Added in API level 1
open fun getTestContext(): Context!

Deprecated: Deprecated in Java.

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

setContext

Added in API level 1
open fun setContext(context: Context!): Unit

Deprecated: Deprecated in Java.

setTestContext

Added in API level 1
open fun setTestContext(context: Context!): Unit

Deprecated: Deprecated in Java.

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 method.

testAndroidTestCaseSetupProperly

Added in API level 1
open fun testAndroidTestCaseSetupProperly(): Unit

Deprecated: Deprecated in Java.

Protected methods

scrubClass

Added in API level 1
protected open fun scrubClass(testCaseClass: Class<*>!): Unit

Deprecated: Deprecated in Java.

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
protected open fun setUp(): Unit

Deprecated: Deprecated in Java.

tearDown

Added in API level 1
protected open fun tearDown(): Unit

Deprecated: Deprecated in Java.

Properties

mContext

Added in API level 1
protected var mContext: Context!

Deprecated: Deprecated in Java.