ActivityTestRule

ActivityTestRule(activityClass: Class<T!>!)

Similar to ActivityTestRule but with "touch mode" disabled.

ActivityTestRule(activityClass: Class<T!>!, initialTouchMode: Boolean)

Similar to ActivityTestRule but defaults to launch the activity under test once per org.junit.Test method. It is launched before the first org.junit.Before method, and terminated after the last org.junit.After method.

ActivityTestRule(
    activityClass: Class<T!>!,
    initialTouchMode: Boolean,
    launchActivity: Boolean
)

Similar to ActivityTestRule but defaults to launch the Activity with the default target package name getTargetContext and FLAG_ACTIVITY_NEW_TASK launch flag.

ActivityTestRule(
    activityFactory: SingleActivityFactory<T!>!,
    initialTouchMode: Boolean,
    launchActivity: Boolean
)

Creates an ActivityTestRule for the Activity under test.

ActivityTestRule(
    activityClass: Class<T!>!,
    targetPackage: String,
    launchFlags: Int,
    initialTouchMode: Boolean,
    launchActivity: Boolean
)

Creates an ActivityTestRule for the Activity under test.

fun finishActivity(): Unit

Finishes the currently launched Activity.

fun getActivity(): T!

Returns the reference to the activity under test.

The reference to the activity is assigned during the initial creation of the acivity and for every sinlge OnResumed lifecycle change.

Note: Lifecycle changes happen on the UI thread (not the instrumentation thread where this test code usually executes). Thus, the return value may vary depending on timing.

For example, if the activity is finished and relaunched, the reference returned by this method will point to the new instance of the activity assuming OnResumed was called prior to calling this method.

If the activity wasn't created yet or already finished, null will be returned.

Note: The activity reference is stored in a weak reference which means if the activity under test is detroyed (ex. back button was pressed) then the system no longer holds a strong reference to the acitivty and this refernce may get garbage collected.

fun launchActivity(startIntent: Intent?): T!

Launches the Activity under test.

Don't call this method directly, unless you explicitly requested not to lazily launch the Activity manually using the launchActivity flag in ActivityTestRule.

Usage:

   @Test
   public void customIntentToStartActivity() {
       Intent intent = new Intent(Intent.ACTION_PICK);
       activity = mActivityRule.launchActivity(intent);
   }

fun runOnUiThread(runnable: Runnable!): Unit

Helper method for running part of a method on the UI thread, blocking until it is complete.

Note: In most cases it is simpler to annotate the test method with UiThreadTest.

Use this method if you need to switch in and out of the UI thread within your method.

protected fun afterActivityFinished(): Unit

Override this method to execute any code that should run after the currently launched Activity is finished. This method is called after each test method, including any method annotated with org.junit.After.

Prefer org.junit.After over this method. This method should usually not be overwritten directly in tests and only be used by subclasses of ActivityTestRule to get notified when the activity is created and visible but test runs.

protected fun afterActivityLaunched(): Unit

Override this method to execute any code that should run after your Activity is launched, but before any test code is run including any method annotated with org.junit.Before.

Prefer org.junit.Before over this method. This method should usually not be overwritten directly in tests and only be used by subclasses of ActivityTestRule to get notified when the activity is created and visible but test runs.

protected fun beforeActivityLaunched(): Unit

Override this method to execute any code that should run before your Activity is created and launched. This method is called before each test method, including any method annotated with org.junit.Before.

protected fun getActivityIntent(): Intent!

Override this method to set up a custom Intent as if supplied to startActivity. Custom Intents provided by this method will take precedence over default Intents that where created in the constructor but be overridden by any Intents passed in through launchActivity.

The default Intent (if this method returns null or is not overwritten) is: action = ACTION_MAIN flags = FLAG_ACTIVITY_NEW_TASK All other intent fields are null or empty.

If the custom Intent provided by this methods overrides any of the following fields:

• componentName through setClassName
• launch flags through setFlags

These custom values will be used to start the Activity. However, if some of these values are not set, the default values documented in ActivityTestRule are supplemented.