{% setvar book_path %}/reference/androidx/_book.yaml{% endsetvar %} {% include "_shared/_reference-head-tags.html" %}

ActivityScenarioRule

public final class ActivityScenarioRule<A extends Activity> extends ExternalResource

java.lang.Object
↳	org.junit.rules.ExternalResource
	↳	androidx.test.ext.junit.rules.ActivityScenarioRule

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

You can access the androidx.test.core.app.ActivityScenario instance via getScenario. 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 the now deprecated .

This rule does not support calling scenario.getResult(). Use ActivityScenario.launchActivityForResult() when the Activity result is needed.

Example:

  @Rule
  public ActivityScenarioRule<MyActivity> rule =
      new ActivityScenarioRule<>(MyActivity.class);

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

Summary

Public fields
`@Nullable ActivityScenario<A>`	`scenario`

Public constructors
`ActivityScenarioRule(Class<A> activityClass)` Constructs ActivityScenarioRule for a given activity class.
`ActivityScenarioRule(Intent startActivityIntent)` Constructs ActivityScenarioRule with a given intent.
`ActivityScenarioRule( Class<A> activityClass, @Nullable Bundle activityOptions )`
`ActivityScenarioRule( Intent startActivityIntent, @Nullable Bundle activityOptions )`

Public methods
`ActivityScenario<A>`	`getScenario()` Returns `ActivityScenario` of the given activity class.

Protected methods
`void`	`after()`
`void`	`before()`

Inherited methods

From class org.junit.rules.ExternalResource

Statement

apply(Statement base, Description description)

Public fields

scenario

public @Nullable ActivityScenario<A> scenario

Public constructors