public final class

ActivityScenarioRule

extends ExternalResource
java.lang.Object
   ↳ org.junit.rules.ExternalResource
     ↳ androidx.test.ext.junit.rules.ActivityScenarioRule<A extends android.app.Activity>

Class Overview

ActivityScenarioRule launches a given activity before the test starts and closes after the test.

You can access to scenario interface via getScenario() method. You may finish your activity manually in your test, it will not cause any problems and this rule does nothing after the test in such cases.

This rule is an upgraded version of ERROR(/androidx.test.rule.ActivityTestRule). The previous version will be deprecated and eventually be removed from the library in the future.

Example:
  @RuleActivityScenarioRule<MyActivity> rule = new ActivityScenarioRule<>(MyActivity.class);

  @Testpublic void myTest() {
     ActivityScenario<MyActivity> scenario = rule.getScenario();
     // Your test code goes here.
   }
 

Summary

Public Constructors
ActivityScenarioRule(Class<A> activityClass)
Constructs ActivityScenarioRule for a given activity class.
ActivityScenarioRule(Intent startActivityIntent)
Constructs ActivityScenarioRule for a given activity class and intent.
Public Methods
ActivityScenario<A> getScenario()
Returns ActivityScenario of the given activity class.
Protected Methods
void after()
void before()
[Expand]
Inherited Methods
From class org.junit.rules.ExternalResource
From class java.lang.Object
From interface org.junit.rules.TestRule

Public Constructors

public ActivityScenarioRule (Class<A> activityClass)

Constructs ActivityScenarioRule for a given activity class.

Parameters
activityClass Class: an activity class to launch

public ActivityScenarioRule (Intent startActivityIntent)

Constructs ActivityScenarioRule for a given activity class and intent.

Parameters
startActivityIntent Intent: an intent to start the activity

Public Methods

public ActivityScenario<A> getScenario ()

Returns ActivityScenario of the given activity class.

Returns
ActivityScenario<A> a non-null ActivityScenario instance
Throws
NullPointerException if you call this method while test is not running

Protected Methods

protected void after ()

protected void before ()

Throws
Throwable