Loading...
Loading...
Use this skill to launch, drive, and tear down an Activity from an instrumentation test using `ActivityScenario` and the JUnit4 wrapper `ActivityScenarioRule`. Covers `ActivityScenario.launch<A>()`, `launch(intent)`, `launchActivityForResult`, `moveToState(Lifecycle.State.*)`, `recreate()`, `onActivity { }`, the `Closeable` / `use { }` idiom, and the manifest declaration trap. Establishes that `androidx.test.ext.junit.rules.ActivityScenarioRule` is the single canonical FQN — `androidx.test.rule.ActivityScenarioRule` does NOT exist; the package only ships the deprecated `ActivityTestRule`. Use when the user reports `ActivityNotFoundException`, `ActivityTestRule deprecated`, "how do I rotate the activity in a test", "how do I read setResult from a test", "how do I survive recreate", "Cannot run onActivity since Activity is not alive", or "test deadlocks on launch".
npx skill4agent add skydoves/android-testing-skills launching-activities-with-activityscenarioActivityScenarioActivityTestRuleActivityCREATEDSTARTEDRESUMEDDESTROYEDonActivity { }ActivityScenarioRulelaunchbeforecloseafterActivityTestRuleActivityNotFoundExceptionrecreate()rememberrememberSaveableonActivitysetResult(...) + finish()Activity.RESULT_*Settings.Global.ALWAYS_FINISH_ACTIVITIESActivityScenario../launching-fragments-with-fragmentscenario/SKILL.mdandroidx.activity.ComponentActivitycreateComposeRule()../../../compose/setup/configuring-test-dependencies/SKILL.md../../runner/running-instrumented-tests-with-androidjunit4/SKILL.md../../uiautomator/cross-app-tests-with-uiautomator/SKILL.md../../../compose/setup/setting-up-host-vs-device-tests/SKILL.mdandroidTestImplementation("androidx.test:core:1.7.0")androidx.test.core.app.ActivityScenarioandroidTestImplementation("androidx.test.ext:junit:1.3.0")androidx.test.ext.junit.rules.ActivityScenarioRuleandroidTestImplementation("androidx.test:runner:1.7.0")testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"src/androidTest/AndroidManifest.xmlsrc/debug/AndroidManifest.xmlandroidx.test.core.app.ActivityScenarioimport androidx.test.core.app.ActivityScenario
import androidx.test.core.app.launchActivity // Kotlin reified extension
// Plain class-based launch
val s1: ActivityScenario<MyActivity> = ActivityScenario.launch(MyActivity::class.java)
// Reified inline (KTX)
val s2 = launchActivity<MyActivity>()
// With explicit intent (extras / data uri / action)
val intent = Intent(ApplicationProvider.getApplicationContext(), MyActivity::class.java)
.putExtra("user_id", 42)
val s3 = ActivityScenario.launch<MyActivity>(intent)
// For activities that call setResult(...) + finish() before reaching RESUMED
val s4 = ActivityScenario.launchActivityForResult(MyActivity::class.java)launchRESUMEDlaunchActivityForResultscenario.resultandroidx.test.core.app.ActivityScenariotasks/research/R2-scenario.mdmoveToState(Lifecycle.State.*)CREATEDSTARTEDRESUMEDDESTROYEDDESTROYEDimport androidx.lifecycle.Lifecycle
scenario.moveToState(Lifecycle.State.STARTED) // pause behind another activity
scenario.moveToState(Lifecycle.State.RESUMED) // back to foreground
scenario.moveToState(Lifecycle.State.DESTROYED) // terminal — close() is now a no-opmoveToState@UiThreadTestLooperawait(...)recreate()onSaveInstanceStateonRestoreInstanceStaterememberSaveableSavedStateHandleBundleremember { ... }varscenario.recreate()
scenario.onActivity { activity ->
// activity is now a fresh instance
assertThat(activity.viewModel.count).isEqualTo(2) // survives if hoisted in the ViewModel
}recreate()rememberrememberSaveableonActivity { activity -> }scenario.onActivity { activity ->
activity.findViewById<EditText>(R.id.email).setText("test@example.com")
activity.viewModel.refresh()
}activityrecreate()close()var captured: MyActivity? = null
scenario.onActivity { captured = it }
val current: MyActivity = captured!!Activity.RESULT_*scenario.resultlaunchActivityForResultsetResult(...) + finish()val scenario = ActivityScenario.launchActivityForResult(LoginActivity::class.java)
scenario.onActivity { it.confirmLogin() } // calls setResult(RESULT_OK) + finish()
val result: Instrumentation.ActivityResult = scenario.result
assertThat(result.resultCode).isEqualTo(Activity.RESULT_OK)ActivityScenarioRuleandroidx.test.ext.junit.rules.ActivityScenarioRuleandroidx.test.ruleActivityScenarioRuleActivityTestRuleimport androidx.test.ext.junit.rules.ActivityScenarioRule
import org.junit.Rule
@get:Rule
val activityRule = ActivityScenarioRule(LoginActivity::class.java)
@Test
fun loginButtonEnablesAfterEmail() {
activityRule.scenario.onActivity { it.email = "x@y.z" }
// ...
}ActivityScenario.launchbeforescenario.close()after@Rule(order = N)@get:Rule(order = 0) val hiltRule = HiltAndroidRule(this)
@get:Rule(order = 1) val activityRule = ActivityScenarioRule(LoginActivity::class.java)ui-test-manifestandroidx.activity.ComponentActivitysrc/androidTest/AndroidManifest.xmlsrc/debug/AndroidManifest.xml<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<application>
<activity android:name=".MyTestHostActivity" android:exported="true" />
</application>
</manifest>ActivityScenario.launchActivityNotFoundException../../../compose/setup/configuring-test-dependencies/SKILL.mdActivityScenarioRuleclose()use { }java.io.CloseableActivityScenario.launch<MyActivity>().use { scenario ->
scenario.onActivity { /* ... */ }
}close()DESTROYEDmoveToState(DESTROYED)ActivityTestRuleActivityScenarioRule// WRONG
import androidx.test.rule.ActivityTestRule
@Rule
public ActivityTestRule<MyActivity> rule = new ActivityTestRule<>(MyActivity.class);
// WRONG because: ActivityTestRule is @Deprecated at rules-1.7.0/.../ActivityTestRule.java:85.
// Its launch is racy with main-thread state, and lifecycle control is ad hoc.// RIGHT
import androidx.test.ext.junit.rules.ActivityScenarioRule
@get:Rule
val rule = ActivityScenarioRule(MyActivity::class.java)ActivityScenarioRule// WRONG
import androidx.test.rule.ActivityScenarioRule // class does not exist!
// WRONG because: androidx.test:rules ships only the deprecated ActivityTestRule, not
// ActivityScenarioRule. The IDE auto-completes neither — the import is unresolved.// RIGHT
import androidx.test.ext.junit.rules.ActivityScenarioRule
// Lives in androidx.test.ext:junit. This is the SINGLE canonical FQN.launchmoveToState// WRONG
@Test @UiThreadTest
fun launchOnUiThread() {
val scenario = ActivityScenario.launch(MyActivity::class.java) // deadlocks
}
// WRONG because: launch / moveToState / onActivity / close all await an instrumentation
// barrier on the test thread. From the UI thread the barrier never fires (R2 lines 823-828).// RIGHT
@Test
fun launchFromTestThread() {
val scenario = ActivityScenario.launch(MyActivity::class.java)
scenario.onActivity { activity ->
// UI-thread work goes here, NOT a recursive moveToState/launch
}
}// WRONG
var leaked: MyActivity? = null
scenario.onActivity { leaked = it }
scenario.recreate()
leaked!!.someField // stale reference; underlying instance is gone// RIGHT
scenario.onActivity { activity ->
activity.someField = "new value"
}
// or: re-acquire after recreate()
scenario.recreate()
scenario.onActivity { activity ->
assertThat(activity.someField).isEqualTo("new value (restored from saved state)")
}// WRONG
// Toggle Settings.Global.ALWAYS_FINISH_ACTIVITIES to force recreation between activities.
// WRONG because: ActivityScenario does not honor "Don't keep activities" — its barrier
// model expects deterministic transitions. Use scenario.recreate() instead.// RIGHT
scenario.recreate() // deterministic onSaveInstanceState → destroy → create → onRestoreInstanceStateActivityScenarioRuleandroidx.test.ext.junit.rulesandroidx.test.ruleActivityTestRule@DeprecatedActivityScenario.launchmoveToStatecloseactivityonActivityrecreate()close()Settings.Global.ALWAYS_FINISH_ACTIVITIESActivityScenarioscenario.recreate()src/androidTest/AndroidManifest.xmlsrc/debug/AndroidManifest.xmlui-test-manifestandroidx.activity.ComponentActivitymoveToState(Lifecycle.State.DESTROYED)close()ActivityScenarioRuleActivityScenarioRuleActivityScenario.launch(...).use { }@get:Rule(order = 0)order = 1ActivityScenarioRulegrep -r "androidx.test.rule.ActivityScenarioRule" src/androidx.test.ext.junit.rules.ActivityScenarioRulegrep -r "ActivityTestRule" src/src/androidTest/AndroidManifest.xmlsrc/debug/AndroidManifest.xmlscenario.recreate()rememberSaveableSavedStateHandleonSaveInstanceState@UiThreadTestlaunchmoveToStateclose./gradlew :<module>:connectedDebugAndroidTestActivityNotFoundExceptionCannot run onActivity since Activity is not aliveActivity.RESULT_*launchActivityForResultlaunchandroidx.test.core.app.ActivityScenariolaunchlaunchActivityForResultmoveToStaterecreateonActivitystateresultclosetasks/research/R2-scenario.mdjunit-1.3.0/androidx/test/ext/junit/rules/ActivityScenarioRule.javarules-1.7.0/androidx/test/rule/ActivityTestRule.java@DeprecatedActivityScenariotasks/research/R2-scenario.mdrecreate()rememberdocs/CORPUS.mdtasks/research/R1-androidx-test-core.mdActivityScenarioRule