Test

Testing in Android.

This table lists all the artifacts in the androidx.test group.

Artifact Stable Release Release Candidate Beta Release Alpha Release
annotation 1.0.1 - - 1.1.0-alpha03
core 1.5.0 - - 1.6.0-alpha05
espresso 3.5.1 - - 3.6.0-alpha03
espresso-device - - - 1.0.0-alpha08
ext.junit 1.1.5 - - 1.2.0-alpha03
ext:junit-gtest - - - 1.0.0-alpha01
ext.truth 1.5.0 - - 1.6.0-alpha03
monitor 1.6.1 - - 1.7.0-alpha04
orchestrator 1.4.2 - - 1.5.0-alpha03
runner 1.5.2 - - 1.6.0-alpha06
rules 1.5.0 - - 1.6.0-alpha03
services 1.4.2 - - 1.5.0-alpha03
This library was last updated on: February 29, 2024

Declaring dependencies

To add a dependency on androidx.test, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.

Add the dependencies for the artifacts you need in the build.gradle file for your app or module:

Groovy

dependencies {
    // To use the androidx.test.core APIs
    androidTestImplementation "androidx.test:core:1.5.0"
    // Kotlin extensions for androidx.test.core
    androidTestImplementation "androidx.test:core-ktx:1.5.0"

    // To use the androidx.test.espresso
    androidTestImplementation "androidx.test.espresso:espresso-core:3.5.1"

    // To use the JUnit Extension APIs
    androidTestImplementation "androidx.test.ext:junit:1.1.5"
    // Kotlin extensions for androidx.test.ext.junit
    androidTestImplementation "androidx.test.ext:junit-ktx:1.1.5"

    // To use the Truth Extension APIs
    androidTestImplementation "androidx.test.ext:truth:1.5.0"

    // To use the androidx.test.runner APIs
    androidTestImplementation "androidx.test:runner:1.5.2"

    // To use android test orchestrator
    androidTestUtil "androidx.test:orchestrator:1.4.2"

}

Kotlin

dependencies {
    // To use the androidx.test.core APIs
    androidTestImplementation("androidx.test:core:1.5.0")
    // Kotlin extensions for androidx.test.core
    androidTestImplementation("androidx.test:core-ktx:1.5.0")

    // To use the androidx.test.espresso
    androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1")

    // To use the JUnit Extension APIs
    androidTestImplementation("androidx.test.ext:junit:1.1.5")
    // Kotlin extensions for androidx.test.ext.junit
    androidTestImplementation("androidx.test.ext:junit-ktx:1.1.5")

    // To use the Truth Extension APIs
    androidTestImplementation("androidx.test.ext:truth:1.5.0")

    // To use the androidx.test.runner APIs
    androidTestImplementation("androidx.test:runner:1.5.2")

    // To use android test orchestrator
    androidTestUtil("androidx.test:orchestrator:1.4.2")
}

For more information about dependencies, see Add Build Dependencies.

Feedback

Your feedback helps make Jetpack better. Let us know if you discover new issues or have ideas for improving this library. Please take a look at the existing issues in this library before you create a new one. You can add your vote to an existing issue by clicking the star button.

Create a new issue

See the Issue Tracker documentation for more information.

Annotation 1.1.0

Annotation 1.1.0-alpha03

January 26, 2024

androidx.test:annotation:1.1.0-alpha03} is released.

API Changes

  • Un-hide ExperimentalTestApi

Annotation 1.1.0-alpha02

November 29, 2023

androidx.test:annotation:1.1.0-alpha02} is released.

API Changes

  • minSdkVersion is now 19, targetSdkVersion is now 34

New Features

Annotation 1.1.0-alpha01

March 21, 2023

androidx.test:annotation:1.1.0-alpha01 is released.

Dependency changes

  • Update to kotlin stdlib 1.7.22
  • Major release toolchain update: now compiled to java8 bytecode

Annotation 1.0.1

Annotation 1.0.1

November 8, 2022

androidx.test:annotation:1.0.1 is released.

Changes since 1.0.0 include:

Dependency changes

  • Update to kotlin stdlib 1.7.10

Annotation 1.0.1-rc01

October 26, 2022

androidx.test:annotation:1.0.1-rc01 is released.

Annotation 1.0.1-beta01

October 6, 2022

androidx.test:annotation:1.0.1-beta01 is released.

Dependency changes

  • Update to kotlin stdlib 1.7.10

Annotation 1.0.1-alpha01

June 1, 2022

androidx.test:annotation:1.0.1-alpha01 is released.

Bug fixes

  • Revert to javac 11 to prevent IncompatibleClassChangeErrors [#1351]

Annotation 1.0.0

Annotation 1.0.0

Dec 13, 2021

androidx.test:annotation:1.0.0 is released.

New artifact, currently for internal androidx.test use.

Annotation 1.0.0-rc01

Nov 18, 2021

androidx.test:annotation:1.0.0-rc01 is released.

Annotation 1.0.0-beta01

Nov 8, 2021

androidx.test:annotation:1.0.0-beta01 is released.

Annotation 1.0.0-alpha02

Oct 4, 2021

androidx.test:annotation:1.0.0-alpha02 is released.

Annotation 1.0.0-alpha01

Sept 28, 2021

androidx.test:annotation:1.0.0-alpha01 is released.

API Changes

  • Add new ExperimentalTestApi and InternalTestApi annotations

Core 1.6.0

Core Core-ktx 1.6.0-alpha05

January 26, 2024

androidx.test:core:1.6.0-alpha05 and androidx.test:core-ktx:1.6.0-alpha05 are released.

Bug Fixes

  • Update Activity Scenario reference documentation to fix missing links
  • Remove all support for Android SDKs < 19. Minimum is API 19 (Android Kit Kat 4.4)
  • Reference doc cleanup - document previously missing parameters, fix links, etc

Core Core-ktx 1.6.0-alpha04

December 05, 2023

androidx.test:core:1.6.0-alpha04 and androidx.test:core-ktx:1.6.0-alpha04 are released.

Bug Fixes

  • Activity starts are automatically opted in to allow background activity launches when targetSdk >= 34

Core Core-ktx 1.6.0-alpha03

November 29, 2023

androidx.test:core:1.6.0-alpha03 and androidx.test:core-ktx:1.6.0-alpha03 are released.

Bug Fixes

  • Fix ActivityScenario.launchActivityWithResult when targetSdk = 34

API Changes

  • targetSdkVersion is now 34

New Features

Core Core-ktx 1.6.0-alpha02

September 18, 2023

androidx.test:core:1.6.0-alpha02 and androidx.test:core-ktx:1.6.0-alpha02 are released.

Features * Updates ViewCapture to accept an optional Rect so that it can work for Compose.

Bug fixes

  • Fix issue where Activity#isChangingConfigurations is incorrectly false during ActivityScenario#recreate
  • Move UiAutomation#takeScreenshot call off main thread.
  • Fix captureToBitmap for Views inside a Dialog on APIs >= 26.

Dependency changes * minSdkVersion is now 19

Core Core-ktx 1.6.0-alpha01

March 21, 2023

androidx.test:core:1.6.0-alpha01 and androidx.test:core-ktx:1.6.0-alpha01 are released.

Features * Preliminary support for robolectric was added to ViewCapture.captureToBitmap

Bug fixes

  • Fix captureToBitmap for DecorView's
  • Attempt to improve reliability of DeviceCapture by retrying takeScreenshot

Dependency changes

  • Update to kotlin stdlib 1.7.22
  • Major release toolchain update: now compiled to java8 bytecode
  • Update to androidx.test:monitor:1.70-alpha01

Core 1.5.0

Core Core-ktx 1.5.0

November 8, 2022

androidx.test:core:1.5.0 and androidx.test:core-ktx:1.5.0 are released.

Changes since 1.4.0 include:

New features

  • Record android Trace spans for ActivityScenario launch and close.
  • Add new experimental APIs for screenshots. These APIs will automatically select the highest fidelity for taking screenshots based on platform API level, and support the Automated Test Device (ATD) emulator images.
    • View.captureToBitmap extension function
    • Window.captureRegionToBitmap extension function
    • takeScreenshot()
  • Add experimental Bitmap.writeToTestStorage API

API changes

  • Add ActivityScenario#launchActivityForResult API and modify ActivityScenario#launch to remove use of Bootstrap Activity API. This change should improve performance and stability of ActivityScenario#launch. ActivityScenario#getResult will now enforce that it can only be used with ActivityScenario#launchActivityForResult

Bug fixes

  • Fix ActivityScenario#launch when targeting and running on Android 33
  • Use elapsedRealtime instead of currentTimeMillis to track ActivityScenario timeouts.
  • Fix ActivityScenario's issue with starting an Activity from intent with package name in self-instrumenting tests.
  • Reduce ActivityScenario overhead by using plain whitebackground and disabling transition animations in internal Activities

Dependency changes

  • Update to
    • kotlin stdlib 1.7.10
    • androidx.lifecycle:lifecycle-common:2.3.1
    • androidx.annotation:annotation:1.2.0
  • Add
    • androidx.test.services:storage:1.4.2
    • com.google.guava:listenablefuture:1.0
    • androidx.concurrent:concurrent-futures:1.1.0

Core Core-ktx 1.5.0-rc01

October 26, 2022

androidx.test:core:1.5.0-rc01 and androidx.test:core-ktx:1.5.0-rc01 are released.

Core Core-ktx 1.5.0-beta01

October 6, 2022

androidx.test:core:1.5.0-beta01 and androidx.test:core-ktx:1.5.0-beta01 are released.

API changes

  • Annotate new APIs with NonNull/Nullable

Core Core-ktx 1.5.0-alpha02

August 22, 2022

androidx.test:core:1.5.0-alpha02 and androidx.test:core-ktx:1.5.0-alpha02 are released.

API changes

  • Modify ActivityScenario#launch to remove use of Bootstrap Activity API. This change should improve performance and stability of ActivityScenario#launch. ActivityScenario#getResult will now enforce that it can only be used with ActivityScenario#launchActivityForResult

Bug fixes

  • Fix ActivityScenario#launch when targeting and running on Android T
  • Use elapsedRealtime instead of currentTimeMillis to track ActivityScenario timeouts.

Dependency changes

  • Update to kotlin stdlib 1.7.10

Core Core-ktx 1.5.0-alpha01

June 21, 2022

androidx.test:core:1.5.0-alpha01 and androidx.test:core-ktx:1.5.0-alpha01 are released.

API changes

  • Add ActivityScenario#launchActivityForResult API. This API will replace use of ActivityScenario#launch when retrieving activity results.

Core 1.4.1

Core Core-ktx 1.4.1-alpha07

June 1, 2022

androidx.test:core:1.4.1-alpha07 and androidx.test:core-ktx:1.4.1-alpha07 are released.

Bug fixes

  • Revert to javac 11 to prevent IncompatibleClassChangeErrors [#1351]

Dependency changes

  • Update to kotlin stdlib 1.6.21

Core Core-ktx 1.4.1-alpha06

April 28, 2022

androidx.test:core:1.4.1-alpha06 and androidx.test:core-ktx:1.4.1-alpha06 are released.

Bug fixes * Fix ActivityScenario's issue with starting an Activity from intent with package name in self-instrumenting tests.

Core Core-ktx 1.4.1-alpha05

Mar 21, 2022

androidx.test:core:1.4.1-alpha05 and androidx.test:core-ktx:1.4.1-alpha05 are released.

Core Core-ktx 1.4.1-alpha04

Feb 11, 2022

androidx.test:core:1.4.1-alpha04 and androidx.test:core-ktx:1.4.1-alpha04 are released.

New Features

  • Record android Trace spans for ActivityScenario launch and close.

Dependency Changes

  • Add androidx.tracing dependency
  • Update to kotlin stdlib 1.6.10

Core Core-ktx 1.4.1-alpha03

Oct 4, 2021

androidx.test:core:1.4.1-alpha03 and androidx.test:core-ktx:1.4.1-alpha03 are released.

Bug fixes

  • Fix visibility of View.captureToBitmap and Window.captureRegionToBitmap extensions
  • Add clearer exception handling to Bitmap.writeToTestStorage and screenshot methods

Core Core-ktx 1.4.1-alpha02

Sept 28, 2021

androidx.test:core:1.4.1-alpha02 and androidx.test:core-ktx:1.4.1-alpha02 are released.

New Features

  • Add new experimental APIs for screenshots:
    • View.captureToBitmap extension function
    • Window.captureRegionToBitmap extension function
    • takeScreenshot()
  • Add experimental Bitmap.writeToTestStorage API

Dependency Changes

  • Add dependencies to
    • kotlin stdlib 1.5.31
    • androidx.test.services:storage:1.4.1-alpha02
    • com.google.guava:listenablefuture:1.0
    • androidx.concurrent:concurrent-futures:1.1.0
  • Update dependency versions to
    • androidx.lifecycle:lifecycle-common:2.3.1
    • androidx.annotation:annotation:1.2.0

Core Core-ktx 1.4.1-alpha01

Aug 23, 2021

androidx.test:core:1.4.1-alpha01 and androidx.test:core-ktx:1.4.1-alpha01 are released.

Bug Fixes

  • Reduce ActivityScenario overhead by using plain whitebackground and disabling transition animations in internal Activities

Dependency Changes

  • -ktx: Explicitly depend on kotlin stdlib 1.4.30

Espresso 3.6.0

Espresso 3.6.0-alpha03

January 26, 2024

The following artifacts were released:

  • androidx.test.espresso:espresso-accessibility:3.6.0-alpha03
  • androidx.test.espresso:espresso-core:3.6.0-alpha03
  • androidx.test.espresso:espresso-contrib:3.6.0-alpha03
  • androidx.test.espresso:espresso-idling-resource:3.6.0-alpha03
  • androidx.test.espresso:espresso-intents:3.6.0-alpha03
  • androidx.test.espresso:espresso-remote:3.6.0-alpha03
  • androidx.test.espresso:espresso-web:3.6.0-alpha03
  • androidx.test.espresso.idling:idling-concurrent:3.6.0-alpha03
  • androidx.test.espresso.idling:idling-net:3.6.0-alpha03

Bug Fixes

  • Fix typo in AdapterDataLoaderAction error message
  • Remove Kotlin collect stdlib calls in Java from espresso
  • Reference doc cleanup - document previously missing parameters, fix links, etc
  • Remove Kotlin StringKt calls from Java code
  • Remove all support for Android SDKs < 19. Minimum is API 19 (Android Kit Kat 4.4)
  • Stop posting empty tasks to background threads when running in non-remote mode
  • Better handle exceptions that may occur in DefaultFailureHandler's hierarchy capture and screenshot process.

API Changes

  • Mark generated IInteractionExecutionStatus class as RestrictTo LIBRARY_GROUP
  • Remove ExperimentalTestApi from RuntimePermissionStubber

Espresso 3.6.0-alpha02

November 29, 2023

The following artifacts were released:

  • androidx.test.espresso:espresso-accessibility:3.6.0-alpha02
  • androidx.test.espresso:espresso-core:3.6.0-alpha02
  • androidx.test.espresso:espresso-contrib:3.6.0-alpha02
  • androidx.test.espresso:espresso-idling-resource:3.6.0-alpha02
  • androidx.test.espresso:espresso-intents:3.6.0-alpha02
  • androidx.test.espresso:espresso-remote:3.6.0-alpha02
  • androidx.test.espresso:espresso-web:3.6.0-alpha02
  • androidx.test.espresso.idling:idling-concurrent:3.6.0-alpha02
  • androidx.test.espresso.idling:idling-net:3.6.0-alpha02

Bug Fixes

  • Fix the description of IsPlatformPopup to match the behavior.
  • Fix deprecated obtainMovement impl that used the wrong coordinates.
  • Replace broken links to junit.org javadoc with @link.

API Changes

  • Adding a new IsActivatedMatcher to verify if it is activated or not.
  • Makes Espresso.onIdle() work on the main thread to allow for draining the main thread from the main thread.
  • minSdkVersion is now 19, targetSdkVersion is now 34
  • Add scrollTo variant that allows scrolling to 90+% displayed views

New Features

Espresso 3.6.0-alpha01

March 21, 2023

The following artifacts were released:

  • androidx.test.espresso:espresso-accessibility:3.6.0-alpha01
  • androidx.test.espresso:espresso-core:3.6.0-alpha01
  • androidx.test.espresso:espresso-contrib:3.6.0-alpha01
  • androidx.test.espresso:espresso-idling-resource:3.6.0-alpha01
  • androidx.test.espresso:espresso-intents:3.6.0-alpha01
  • androidx.test.espresso:espresso-remote:3.6.0-alpha01
  • androidx.test.espresso:espresso-web:3.6.0-alpha01
  • androidx.test.espresso.idling:idling-concurrent:3.6.0-alpha01
  • androidx.test.espresso.idling:idling-net:3.6.0-alpha01

API changes

  • Deprecate EspressoOptional in favor of @Nullable.
  • Allow customizing espresso's default failure handler to disable screenshots on failures

Dependency changes

  • Update to androidx.test:monitor:1.7.0-alpha01, androidx.test:core:1.6.0-alpha01 and androidx.test:runner:1.6.0-alpha01
  • Update to kotlin stdlib 1.7.22
  • Major release toolchain update:
    • classes are now compiled to java8 bytecode
    • javac compiler switched to OpenJDK 11. This should resolve IncompatibleClassChangeErrors (https://github.com/android/android-test/issues/1642)
    • remove internal guava usage with kotlin stdlib, which resulted in a binary size reduction
    • release aars are no longer proguarded

Espresso 3.5.0

Espresso 3.5.1

January 3, 2023

The following artifacts were released:

  • androidx.test.espresso:espresso-accessibility:3.5.1
  • androidx.test.espresso:espresso-core:3.5.1
  • androidx.test.espresso:espresso-contrib:3.5.1
  • androidx.test.espresso:espresso-idling-resource:3.5.1
  • androidx.test.espresso:espresso-intents:3.5.1
  • androidx.test.espresso:espresso-remote:3.5.1
  • androidx.test.espresso:espresso-web:3.5.1
  • androidx.test.espresso.idling:idling-concurrent:3.5.1
  • androidx.test.espresso.idling:idling-net:3.5.1

Bug fixes

  • Reference doc cleanup: Correct parameter names and remove obsolete 'beta' statements from IdlingThreadPoolExecutor and UriIdlingResource

Dependency changes

  • Update to androidx.test:monitor:1.6.1 to supporting saving screenshots on espresso test failures without test storage

Espresso 3.5.0

November 8, 2022

The following artifacts were released:

  • androidx.test.espresso:espresso-accessibility:3.5.0
  • androidx.test.espresso:espresso-core:3.5.0
  • androidx.test.espresso:espresso-contrib:3.5.0
  • androidx.test.espresso:espresso-idling-resource:3.5.0
  • androidx.test.espresso:espresso-intents:3.5.0
  • androidx.test.espresso:espresso-remote:3.5.0
  • androidx.test.espresso:espresso-web:3.5.0
  • androidx.test.espresso.idling:idling-concurrent:3.5.0
  • androidx.test.espresso.idling:idling-net:3.5.0

New Features

  • Record android Trace spans for Espresso actions
  • Espresso's DefaultFailureHandler now saves a screenshot on test failures to TestStorage
  • Add experimental ViewInteraction.captureToBitmap extension function
  • Save view hierarchy to a file on failures

API changes

  • Promote ViewMatchers hasTextColor and hasBackground as stable APIs
  • Add IntentsRule
  • Add inverted matchers for IntentMatchers.hasExtraWithKey() and BundleMatchers.hasKey()
  • Add a ViewAction that scrolls to the last position in a RecyclerView.
  • Add IntentMatcher.hasExtra API

Bug fixes

  • Preserve tool type on up event
  • Make IdlingRegistry more thread-safe.
  • Support other views for scrollTo()
  • Remove unnecessary interruptEspressoTasks warning logs for each Espresso interaction on Robolectric.
  • Remove timeout in CloseKeyboardAction when running under Robolectric
  • Use consistent InputDevice source for input gesture injection
  • Support simulating ActivityNotFoundExceptions in Espresso Intents.
  • Truncate view hierarchy in exception messages when it gets too large.
  • Display number and list of ambiguously matched views.
  • Validate that onView.check/perform() is invoked on the UI thread

Dependency changes

  • Update to
    • kotlin stdlib 1.7.10
    • jsr305:2.0.2
    • tagsoup:1.2.1
    • androidx.annotation:1.2.0
  • contrib:
    • update to drawer 1.1.1, recycler view 1.2.1, material 1.4.0

Espresso 3.5.0-rc01

October 26, 2022

The following artifacts were released:

  • androidx.test.espresso:espresso-accessibility:3.5.0-rc01
  • androidx.test.espresso:espresso-core:3.5.0-rc01
  • androidx.test.espresso:espresso-contrib:3.5.0-rc01
  • androidx.test.espresso:espresso-idling-resource:3.5.0-rc01
  • androidx.test.espresso:espresso-intents:3.5.0-rc01
  • androidx.test.espresso:espresso-remote:3.5.0-rc01
  • androidx.test.espresso:espresso-web:3.5.0-rc01
  • androidx.test.espresso.idling:idling-concurrent:3.5.0-rc01
  • androidx.test.espresso.idling:idling-net:3.5.0-rc01

Espresso 3.5.0-beta02

October 21, 2022

The following artifacts were released:

  • androidx.test.espresso:espresso-accessibility:3.5.0-beta02
  • androidx.test.espresso:espresso-core:3.5.0-beta02
  • androidx.test.espresso:espresso-contrib:3.5.0-beta02
  • androidx.test.espresso:espresso-idling-resource:3.5.0-beta02
  • androidx.test.espresso:espresso-intents:3.5.0-beta02
  • androidx.test.espresso:espresso-remote:3.5.0-beta02
  • androidx.test.espresso:espresso-web:3.5.0-beta02
  • androidx.test.espresso.idling:idling-concurrent:3.5.0-beta02
  • androidx.test.espresso.idling:idling-net:3.5.0-beta02

API changes

  • Promote ViewMatchers hasTextColor and hasBackground as stable APIs

Bug fixes

  • Fix recyclerview ClassNotFoundExceptions in scrollTo

Dependency changes

Espresso 3.5.0-beta01

October 6, 2022

The following artifacts were released:

  • androidx.test.espresso:espresso-accessibility:3.5.0-beta01
  • androidx.test.espresso:espresso-core:3.5.0-beta01
  • androidx.test.espresso:espresso-contrib:3.5.0-beta01
  • androidx.test.espresso:espresso-idling-resource:3.5.0-beta01
  • androidx.test.espresso:espresso-intents:3.5.0-beta01
  • androidx.test.espresso:espresso-remote:3.5.0-beta01
  • androidx.test.espresso:espresso-web:3.5.0-beta01
  • androidx.test.espresso.idling:idling-concurrent:3.5.0-beta01
  • androidx.test.espresso.idling:idling-net:3.5.0-beta01

API changes

  • Annotate new APIs introduced since 3.4.0 with NonNull/Nullable
  • Add IntentsRule API

Bug fixes

  • Make IdlingRegistry more thread-safe.
  • Support other views for scrollTo()

Dependency changes

  • Update to kotlin stdlib 1.7.10
  • Update to jsr305:2.0.2
  • Update to tagsoup:1.2.1

Espresso 3.5.0-alpha07

June 1, 2022

The following artifacts were released:

  • androidx.test.espresso:espresso-accessibility:3.5.0-alpha07
  • androidx.test.espresso:espresso-core:3.5.0-alpha07
  • androidx.test.espresso:espresso-contrib:3.5.0-alpha07
  • androidx.test.espresso:espresso-idling-resource:3.5.0-alpha07
  • androidx.test.espresso:espresso-intents:3.5.0-alpha07
  • androidx.test.espresso:espresso-remote:3.5.0-alpha07
  • androidx.test.espresso:espresso-web:3.5.0-alpha07
  • androidx.test.espresso.idling:idling-concurrent:3.5.0-alpha07
  • androidx.test.espresso.idling:idling-net:3.5.0-alpha07

Bug fixes

  • Revert to javac 11 to prevent IncompatibleClassChangeErrors [#1351]

Dependency changes

  • Update to kotlin stdlib 1.6.21

Espresso 3.5.0-alpha06

April 28, 2022

The following artifacts were released:

  • androidx.test.espresso:espresso-accessibility:3.5.0-alpha06
  • androidx.test.espresso:espresso-core:3.5.0-alpha06
  • androidx.test.espresso:espresso-contrib:3.5.0-alpha06
  • androidx.test.espresso:espresso-idling-resource:3.5.0-alpha06
  • androidx.test.espresso:espresso-intents:3.5.0-alpha06
  • androidx.test.espresso:espresso-remote:3.5.0-alpha06
  • androidx.test.espresso:espresso-web:3.5.0-alpha06
  • androidx.test.espresso.idling:idling-concurrent:3.5.0-alpha06
  • androidx.test.espresso.idling:idling-net:3.5.0-alpha06

Bug Fixes

  • Remove unncessary interruptEspressoTasks warning logs for each Espresso interaction on Robolectric.

Espresso 3.5.0-alpha05

Mar 21, 2022

The following artifacts were released:

  • androidx.test.espresso:espresso-accessibility:3.5.0-alpha05
  • androidx.test.espresso:espresso-core:3.5.0-alpha05
  • androidx.test.espresso:espresso-contrib:3.5.0-alpha05
  • androidx.test.espresso:espresso-idling-resource:3.5.0-alpha05
  • androidx.test.espresso:espresso-intents:3.5.0-alpha05
  • androidx.test.espresso:espresso-remote:3.5.0-alpha05
  • androidx.test.espresso:espresso-web:3.5.0-alpha05
  • androidx.test.espresso.idling:idling-concurrent:3.5.0-alpha05
  • androidx.test.espresso.idling:idling-net:3.5.0-alpha05

Bug Fixes

  • Remove timeout in CloseKeyboardAction when running under Robolectric

Espresso 3.5.0-alpha04

Feb 11, 2022

The following artifacts were released:

  • androidx.test.espresso:espresso-accessibility:3.5.0-alpha04
  • androidx.test.espresso:espresso-core:3.5.0-alpha04
  • androidx.test.espresso:espresso-contrib:3.5.0-alpha04
  • androidx.test.espresso:espresso-idling-resource:3.5.0-alpha04
  • androidx.test.espresso:espresso-intents:3.5.0-alpha04
  • androidx.test.espresso:espresso-remote:3.5.0-alpha04
  • androidx.test.espresso:espresso-web:3.5.0-alpha04
  • androidx.test.espresso.idling:idling-concurrent:3.5.0-alpha04
  • androidx.test.espresso.idling:idling-net:3.5.0-alpha04

API Changes

  • Add inverted matchers for IntentMatchers.hasExtraWithKey() and BundleMatchers.hasKey()
  • Add a ViewAction that scrolls to the last position in a RecyclerView.

New Features

  • Record android Trace spans for Espresso actions

Bug Fixes

  • Use consistent InputDevice source for input gesture injection
  • Support simulating ActivityNotFoundExceptions in Espresso Intents.
  • Truncate view hierarchy in exception messages when it gets too large.
  • Display number and list of ambiguously matched views.

Dependency Changes

  • Update to kotlin stdlib 1.6.10

Espresso 3.5.0-alpha03

Oct 4, 2021

The following artifacts were released:

  • androidx.test.espresso:espresso-accessibility:3.5.0-alpha03
  • androidx.test.espresso:espresso-core:3.5.0-alpha03
  • androidx.test.espresso:espresso-contrib:3.5.0-alpha03
  • androidx.test.espresso:espresso-idling-resource:3.5.0-alpha03
  • androidx.test.espresso:espresso-intents:3.5.0-alpha03
  • androidx.test.espresso:espresso-remote:3.5.0-alpha03
  • androidx.test.espresso:espresso-web:3.5.0-alpha03
  • androidx.test.espresso.idling:idling-concurrent:3.5.0-alpha03
  • androidx.test.espresso.idling:idling-net:3.5.0-alpha03

New features

  • Espresso's DefaultFailureHandler now saves a screenshot on test failures to TestStorage

Bug fixes

  • Fix visibility and functionality of ViewInteraction.captureToBitmap
  • Validate that onView.check/perform() is invoked on the UI thread

Espresso 3.5.0-alpha02

Sept 28, 2021

The following artifacts were released:

  • androidx.test.espresso:espresso-accessibility:3.5.0-alpha02
  • androidx.test.espresso:espresso-core:3.5.0-alpha02
  • androidx.test.espresso:espresso-contrib:3.5.0-alpha02
  • androidx.test.espresso:espresso-idling-resource:3.5.0-alpha02
  • androidx.test.espresso:espresso-intents:3.5.0-alpha02
  • androidx.test.espresso:espresso-remote:3.5.0-alpha02
  • androidx.test.espresso:espresso-web:3.5.0-alpha02
  • androidx.test.espresso.idling:idling-concurrent:3.5.0-alpha02
  • androidx.test.espresso.idling:idling-net:3.5.0-alpha02

New features

  • Add experimental ViewInteraction.captureToBitmap extension function

Dependency Changes

  • all:
    • update to androidx.annotation:1.2.0
  • core:
    • update to kotlin stdlib 1.5.31
  • contrib:
    • update to drawer 1.1.1, recycler view 1.2.1, materual 1.4.0

Espresso 3.5.0-alpha01

Aug 23, 2021

The following artifacts were released:

  • androidx.test.espresso:espresso-accessibility:3.5.0-alpha01
  • androidx.test.espresso:espresso-core:3.5.0-alpha01
  • androidx.test.espresso:espresso-contrib:3.5.0-alpha01
  • androidx.test.espresso:espresso-idling-resource:3.5.0-alpha01
  • androidx.test.espresso:espresso-intents:3.5.0-alpha01
  • androidx.test.espresso:espresso-remote:3.5.0-alpha01
  • androidx.test.espresso:espresso-web:3.5.0-alpha01
  • androidx.test.espresso.idling:idling-concurrent:3.5.0-alpha01
  • androidx.test.espresso.idling:idling-net:3.5.0-alpha01

New features

  • Save view hierarchy to a file on failures

API Changes

  • Add IntentMatcher.hasExtra API

Dependency Changes

  • core: Depend on kotlin stdlib 1.4.30

Espresso Device 1.0.0

Espresso Device 1.0.0-alpha08

January 26, 2024

androidx.test.espresso:espresso-device:1.0.0-alpha08 is released.

Bug Fixes

  • Add better error messaging when process does not have INTERNET permission
  • Make exception class references in Espresso Device documentation clickable links

API Changes * Remove ExperimentalTestApi from androidx.test.filter.CustomFilter

Espresso Device 1.0.0-alpha07

November 29, 2023

androidx.test.espresso:espresso-device:1.0.0-alpha07 is released.

API Changes

  • Support setting device modes on physical devices

New Features

Espresso Device 1.0.0-alpha06

September 18, 2023

The following artifacts were released:

  • androidx.test.espresso:espresso-device:1.0.0-alpha06

API changes * Support setting screen orientation on physical devices that are open * Remove ActionContext interface

Dependency changes * minSdkVersion is now 19

Espresso Device 1.0.0-alpha05

May 4, 2023

The following artifacts were released:

  • androidx.test.espresso:espresso-device:1.0.0-alpha05

API changes

  • Add experimental APIs for rotating and folding emulators

JUnit Extensions 1.2.0

ext.junit 1.2.0-alpha03

January 26, 2024

androidx.test.ext:junit:1.2.0-alpha03 and androidx.test.ext:junit-ktx:1.2.0-alpha03 are released.

Bug Fixes

  • Reference doc cleanup - document previously missing parameters, fix links, etc

ext.junit 1.2.0-alpha02

November 29, 2023

androidx.test.ext:junit:1.2.0-alpha02 and androidx.test.ext:junit-ktx:1.2.0-alpha02 are released.

API Changes

  • Add AppComponentFactoryRule
  • minSdkVersion is now 19, targetSdkVersion is now 34

New Features

ext.junit 1.2.0-alpha01

March 21, 2023

androidx.test.ext:junit:1.2.0-alpha01 and androidx.test.ext:junit-ktx:1.2.0-alpha01 are released.

API changes

  • Create DeleteFilesRule: an API for removing files between test case execution

Dependency changes

  • Update to androidx.test:monitor:1.7.0-alpha01, androidx.test:core:1.6.0-alpha01, androidx.test.services:storage:1.5.0-alpha01
  • Update to kotlin stdlib 1.7.22
  • Major release toolchain update:
    • classes are now compiled to java8 bytecode
    • javac compiler switched to OpenJDK 11.

JUnit Extensions 1.1.5

ext.junit 1.1.5

January 3, 2023

androidx.test.ext:junit:1.1.5 and androidx.test.ext:junit-ktx:1.1.5 are released.

Bug fixes

  • Fix reference doc formatting for ActivityScenarioRule

JUnit Extensions 1.1.4

ext.junit 1.1.4

November 8, 2022

androidx.test.ext:junit:1.1.4 and androidx.test.ext:junit-ktx:1.1.4 are released.

Changes since 1.1.3 include:

Dependency changes

  • Update to kotlin stdlib 1.7.10
  • Update to org.junit:junit:4.13.2

ext.junit 1.1.4-rc01

October 26, 2022

androidx.test.ext:junit:1.1.4-rc01 and androidx.test.ext:junit-ktx:1.1.4-rc01 are released.

ext.junit 1.1.4-beta01

October 6, 2022

androidx.test.ext:junit:1.1.4-beta01 and androidx.test.ext:junit-ktx:1.1.4-beta01 are released.

Dependency changes

  • Update to kotlin stdlib 1.7.10

ext.junit 1.1.4-alpha07

June 1, 2022

androidx.test.ext:junit:1.1.4-alpha07 and androidx.test.ext:junit-ktx:1.1.4-alpha07 are released.

Bug fixes

  • Revert to javac 11 to prevent IncompatibleClassChangeErrors [#1351]

Dependency changes

  • Update to kotlin stdlib 1.6.21

ext.junit 1.1.4-alpha06

April 28, 2022

androidx.test.ext:junit:1.1.4-alpha06 and androidx.test.ext:junit-ktx:1.1.4-alpha06 are released.

Bug Fixes

  • Minor fix to the AndroidJUnit4 javadoc.

ext.junit 1.1.4-alpha05

Mar 21, 2022

androidx.test.ext:junit:1.1.4-alpha05 and androidx.test.ext:junit-ktx:1.1.4-alpha05 are released.

ext.junit 1.1.4-alpha04

Feb 11, 2022

androidx.test.ext:junit:1.1.4-alpha04 and androidx.test.ext:junit-ktx:1.1.4-alpha04 are released.

** Dependency Changes

  • Update to kotlin stdlib 1.6.10

ext.junit 1.1.4-alpha03

Oct 4, 2021

androidx.test.ext:junit:1.1.4-alpha03 and androidx.test.ext:junit-ktx:1.1.4-alpha03 are released.

ext.junit 1.1.4-alpha02

Sept 28, 2021

androidx.test.ext:junit:1.1.4-alpha02 and androidx.test.ext:junit-ktx:1.1.4-alpha02 are released.

Dependency Changes

  • Update to
    • kotlin stdlib 1.5.31
    • org.junit:junit:4.13.2

ext.junit 1.1.4-alpha01

Aug 23, 2021

androidx.test.ext:junit:1.1.4-alpha01 and androidx.test.ext:junit-ktx:1.1.4-alpha01 are released.

Dependency Changes

  • -ktx: Explicitly depend on kotlin stdlib 1.4.30

Junit-Gtest 1.0

Junit-Gtest 1.0.0-alpha01

March 23, 2022

androidx.test.ext:junit-gtest:1.0.0-alpha01 is released. Version 1.0.0-alpha01 contains these commits.

Features in first release

  • JUnit Gtest is a new library which includes a JUnit runner for running Gtest suites on connected devices.

Truth Extensions 1.6.0

ext.truth 1.6.0-alpha03

January 26, 2024

androidx.test.ext:truth:1.6.0-alpha03 is released.

Bug Fixes

  • Remove all support for Android SDKs < 19. Minimum is API 19 (Android Kit Kat 4.4)

New Features

  • Added PersistableBundleSubject

ext.truth 1.6.0-alpha02

November 29, 2023

androidx.test.ext:truth:1.6.0-alpha02 is released.

API Changes

  • minSdkVersion is now 19, targetSdk is now 34

New Features

ext.truth 1.6.0-alpha01

March 21, 2022

androidx.test.ext:truth:1.6.0-alpha01 is released.

Dependency changes

  • Update to androidx.test:core:1.6.0-alpha01
  • Update to kotlin stdlib 1.7.22
  • Major release toolchain update:
    • classes are now compiled to java8 bytecode
    • javac compiler switched to OpenJDK 11.

Truth Extensions 1.5.0

ext.truth 1.5.0

November 8, 2022

androidx.test.ext:truth:1.5.0 is released.

Changes since 1.4.0 include:

API changes

  • Add BundleSubject#stringArray
  • Add ParcelableSubject.marshallsEquallyTo()
  • Add BundleSubject#doubleFloat

Bug fixes

  • Make Intent matchers fail explicitly for null intent

Dependency Changes

  • Update to
    • com.google.guava:guava:30.1.1-android
    • com.google.truth:truth:1.1.3

ext.truth 1.5.0-rc01

October 26, 2022

androidx.test.ext:truth:1.5.0-rc01 is released.

ext.truth 1.5.0-beta02

October 21, 2022

androidx.test.ext:truth:1.5.0-beta02 is released.

API changes

  • Promote IntentCorrespondences#all as stable API.

ext.truth 1.5.0-beta01

October 6, 2022

androidx.test.ext:truth:1.5.0-beta01 is released.

API changes

  • Annotate new APIs introduced since 1.4.0 with NonNull/Nullable
  • Add BundleSubject#stringArray

ext.truth 1.5.0-alpha07

June 1, 2022

androidx.test.ext:truth:1.5.0-alpha07 is released.

Bug fixes

  • Revert to javac 11 to prevent IncompatibleClassChangeErrors [#1351]

ext.truth 1.5.0-alpha06

April 28, 2022

androidx.test.ext:truth:1.5.0-alpha06 is released.

ext.truth 1.5.0-alpha05

Mar 21, 2022

androidx.test.ext:truth:1.5.0-alpha05 is released.

Bug fixes

  • Make Intent matchers fail explicitly for null intent

ext.truth 1.5.0-alpha04

Feb 11, 2022

androidx.test.ext:truth:1.5.0-alpha04 is released.

ext.truth 1.5.0-alpha03

Oct 4, 2021

androidx.test.ext:truth:1.5.0-alpha03 is released.

ext.truth 1.5.0-alpha02

Sept 28, 2021

androidx.test.ext:truth:1.5.0-alpha02 is released.

API Changes

  • Add ParcelableSubject.marshallsEquallyTo()

Dependency Changes

  • Update to
    • com.google.guava:guava:30.1.1-android
    • com.google.truth:truth:1.1.3

ext.truth 1.5.0-alpha01

Aug 23, 2021

androidx.test.ext:truth:1.5.0-alpha01 is released.

API Changes

  • Add BundleSubject#doubleFloat

Monitor 1.7.0

monitor 1.7.0-alpha04

January 26, 2024

androidx.test:monitor:1.7.0-alpha04 is released.

Bug Fixes

  • Fix synchronization in IntentMonitorImpl callbacks
  • Remove all support for Android SDKs < 19. Minimum is API 19 (Android Kit Kat 4.4)

API Changes * Move androidx.test.platform.tracing back to an internal API

monitor 1.7.0-alpha03

November 29, 2023

androidx.test:monitor:1.7.0-alpha03 is released.

API Changes

  • targetSdkVersion is now 34

New Features

monitor 1.7.0-alpha02

September 18, 2023

androidx.test:monitor:1.7.0-alpha02 is released.

API change * Add AppComponentFactory Rule

Features * Dump thread states when idling resources time out

Bug fixes * Fix captureToBitmap for Views inside a Dialog on APIs >= 26.

Dependency changes * minSdkVersion is now 19

monitor 1.7.0-alpha01

March 21, 2023

androidx.test:monitor:1.7.0-alpha01 is released.

Dependency changes

  • Update to kotlin stdlib 1.7.22
  • Major release toolchain update: now compiled to java8 bytecode

Monitor 1.6.0

monitor 1.6.1

January 3, 2023

androidx.test:monitor:1.6.1 is released.

Bug fixes

  • Fix the default implementation of PlatformTestStorage. This will enable espresso to save screenshots on test failures when androidx.test.services is not configured
  • Reference doc cleanup

monitor 1.6.0

November 8, 2022

androidx.test:monitor:1.6.0 is released.

Changes since 1.5.0 include:

API changes

  • Internal API changes to support ActivityScenario#launchActivityForResult
  • Add internal API for supporting different tracing libraries.

Bug fixes

  • Remove 'Activities that are still in CREATED to STOPPED' log spam

Dependency Changes

  • Add dependency on androidx.tracing

monitor 1.6.0-rc01

October 26, 2022

androidx.test:monitor:1.6.0-rc01 is released.

monitor 1.6.0-beta01

October 6, 2022

androidx.test:monitor:1.6.0-beta01 is released.

monitor 1.6.0-alpha05

August 22, 2022

androidx.test:monitor:1.6.0-alpha05 is released.

API changes

  • Internal API changes to support ActivityScenario#launchActivityForResult

Monitor aka Platform 1.6.0

monitor 1.6.0-alpha04

June 1, 2022

androidx.test:monitor:1.6.0-alpha04 is released.

Bug fixes

  • Revert to javac 11 to prevent IncompatibleClassChangeErrors [#1351]

monitor 1.6.0-alpha03

April 28, 2022

androidx.test:monitor:1.6.0-alpha03 is released.

Bug fixes

  • Remove 'Activities that are still in CREATED to STOPPED' log spam

monitor 1.6.0-alpha02

Mar 21, 2022

androidx.test:monitor:1.6.0-alpha02 is released.

Bug fixes

  • Make HardwareRendererCompat logging less severe.
  • Ensure Trace.endSection is called before Instrumentation#finish.

monitor 1.6.0-alpha01

Feb 11, 2022

androidx.test:monitor:1.6.0-alpha01 is released.

API Changes

  • Add internal plugin API for supporting different tracing libraries.

Dependency Changes

  • Add dependency on androidx.tracing

Monitor aka Platform 1.5.0

monitor 1.5.0

Dec 13, 2021

androidx.test:monitor:1.5.0 is released.

Changes since last 1.4.0 stable release are:

API Changes

  • Add HardwareRendererCompat
  • Add PlatformTestStorage
  • Deprecate androidx.test.annotation.Beta

monitor 1.5.0-rc01

Nov 18, 2021

androidx.test:monitor:1.5.0-rc01 is released.

monitor 1.5.0-beta01

Nov 8, 2021

androidx.test:monitor:1.5.0-beta01 is released.

monitor 1.5.0-alpha03

Oct 4, 2021

androidx.test:monitor:1.5.0-alpha03 is released.

monitor 1.5.0-alpha02

Sept 28, 2021

androidx.test:monitor:1.5.0-alpha02 is released.

API Changes

  • Remove HardwareRendererCompat#enableDrawingIfNecessary
  • Remove ExperimentalTestApi from HardwareRendererCompat
  • Deprecate androidx.test.annotation.Beta

monitor 1.5.0-alpha01

Aug 23, 2021

androidx.test:monitor:1.5.0-alpha01 is released.

API Changes

  • Add HardwareRendererCompat
  • Add PlatformTestStorage

Orchestrator 1.5.0

orchestrator 1.5.0-alpha03

February 29, 2024

androidx.test:orchestrator:1.5.0-alpha03 is released.

New Features

  • Introduce Instrumentation Params Proxying which allows the user to proxy instrumentation arguments to the APK under test (eg: --no-hidden-api-checks).

orchestrator 1.5.0-alpha02

November 29, 2023

androidx.test:orchestrator:1.5.0-alpha02 is released.

API Changes

  • minSdkVersion is now 19

Bug Fixes

  • Fix crash when test name is too long

New Features

orchestrator 1.5.0-alpha01

March 21, 2023

androidx.test:orchestrator:1.5.0-alpha01 is released.

Dependency changes

  • Major release toolchain update. APK is now signed with a different key and you will need to uninstal any previous orchestrator ('adb uninstall androidx.test.orchestrator')

Orchestrator 1.4.2

orchestrator 1.4.2

November 8, 2022

androidx.test:orchestrator:1.4.2 is released.

orchestrator 1.4.2-rc01

October 26, 2022

androidx.test:orchestrator:1.4.2-rc01 is released.

orchestrator 1.4.2-beta01

October 6, 2022

androidx.test:orchestrator:1.4.2-beta01 is released.

orchestrator 1.4.2-alpha04

June 1, 2022

androidx.test:orchestrator:1.4.2-alpha04 is released.

Bug fixes

  • Revert to javac 11 to prevent IncompatibleClassChangeErrors [#1351]

orchestrator 1.4.2-alpha03

April 28, 2022

androidx.test:orchestrator:1.4.2-alpha03 is released.

orchestrator 1.4.2-alpha02

Mar 21, 2022

androidx.test:orchestrator:1.4.2-alpha02 is released.

orchestrator 1.4.2-alpha01

Feb 11, 2022

androidx.test:orchestrator:1.4.2-alpha01 is released.

Orchestrator 1.4.1

orchestrator 1.4.1

Dec 13, 2021

androidx.test:orchestrator:1.4.1 is released.

The notable changes since previous 1.4.0 stable release are:

Bug Fixes

  • Delete obsolete OrchestrationXmlTestRunListener , in part to prevent error messages on Android 11+
  • Support for android API 31

orchestrator 1.4.1-rc01

Nov 18, 2021

androidx.test:orchestrator:1.4.1-rc01 is released.

orchestrator 1.4.1-beta01

Nov 8, 2021

androidx.test:orchestrator:1.4.1-beta01 is released.

orchestrator 1.4.1-alpha03

Oct 4, 2021

androidx.test:orchestrator:1.4.1-alpha03 is released.

orchestrator 1.4.1-alpha02

Sept 28, 2021

androidx.test:orchestrator:1.4.1-alpha02 is released.

orchestrator 1.4.1-alpha01

Aug 23, 2021

androidx.test:orchestrator:1.4.1-alpha01 is released.

Bug Fixes

  • Delete obsolete OrchestrationXmlTestRunListener , in part to prevent error messages on Android 11+

Runner 1.6.0

runner 1.6.0-alpha06

January 26, 2024

androidx.test:runner:1.6.0-alpha06 is released.

Bug Fixes

  • Attempt to clarify limitations and deprecation reasons in RequiresDevice documentation
  • Remove all support for Android SDKs < 19. Minimum is API 19 (Android Kit Kat 4.4)
  • Fix that "-e class" and "-e notClass" on the same class/method should perform the same result (no tests run)

API Changes

  • Mark androidx.test.services.** as RestrictTo LIBRARY_GROUP
  • Remove ExperimentalTestApi from CustomFilter - making it public
  • Remove ExperimentalTestApi from PackagePrefixClasspathSuite - make it public
  • Mark PermissionRequester as RestrictTo LIBRARY_GROUP instead of ExperimentalTestApi

runner 1.6.0-alpha05

November 29, 2023

androidx.test:runner:1.6.0-alpha05 is released.

Bug Fixes

  • TestDiscoveryEventServiceConnection.send() will correctly fail the test instead of hanging if the instrumentation throws a RuntimeException.
  • Stop reparsing all args for every AndroidJUnit4 test class. This should address initialization errors like in #1948.

API Changes

  • minSdkVersion is now 19

New Features

runner 1.6.0-alpha04

August 21, 2023

androidx.test:runner:1.6.0-alpha04 is released.

Bug fixes

  • Force initialization of instrumentationRunListener, to prevent NPEs when instrumenting system server process.

Dependency changes

  • Upgrade to androidx.annotation:1.7.0-beta01

runner 1.6.0-alpha03

June 27, 2023

androidx.test:runner:1.6.0-alpha03 is released.

Bug fixes

  • Attempt to avoid outputting a test result summary which exceeds binder transaction limit.

runner 1.6.0-alpha02

April 25, 2023

androidx.test:runner:1.6.0-alpha02 is released.

Bug fixes

  • Wait up to 2 seconds for activity finisher to run, to prevent situations where it finishes activities mid-test

runner 1.6.0-alpha01

March 21, 2023

androidx.test:runner:1.6.0-alpha01 is released.

Bug fixes

  • Improve error reporting when there is a junit class mismatch due to a custom classloader
  • Fix reporting in logOnly mode for @Ignore-d classes
  • Move instantiation of InstrumentationResultPrinter to after multidex is loaded
  • Register TestStorage before using it in RunnerArgs parsing
  • Execute test classes in order provided to TestRequestBuilder.

Dependency changes

  • Update to androidx.test:monitor:1.7.0-alpha01
  • Major release toolchain update:
    • classes are now compiled to java8 bytecode
    • javac compiler switched to OpenJDK 11.

Runner 1.5.0

runner 1.5.2

January 3, 2023

androidx.test:runner:1.5.2 is released.

Bug fixes

  • Reference doc cleanup

runner 1.5.1

November 9, 2022

androidx.test:runner:1.5.1 is released.

Bug fixes

  • Truncate trace name in TraceRunListener to prevent crash on long test names

runner 1.5.0

November 8, 2022

androidx.test:runner:1.5.0 is released.

Changes since 1.4.0 include:

New features

  • Record android Trace spans for test lifecycle events

API changes

  • Denote the long standing @Beta/@ExperimentalTestApi androidx.test.runner.screenshot as stable but deprecated (in favor of new androidx.test.core/espresso screenshot APIs)
  • Deprecate the '-e timeout' runtime parameter in favor of JUnit's Timeout rule.
  • Add an AbstractFilter class.
  • Add AndroidClasspathSuite and experimental PackagePrefixClasspathSuite
  • No-op and deprecate Google Analytics

Bug fixes

  • Add support for reading from TestStorage in -e testFile
  • Handle case where app crashes before instrumentationResultPrinter is set.
  • Report the process crash immediately in the orchestrator instrumentation listener.
  • Support parameterized test names with commas and hashes.
  • Improve error handling during test discovery phase in orchestrator
  • Enhance error handling in exception scenarios (app crashes, etc)

Dependency Changes

  • Update to
    • org.junit:junit:4.13.2

runner 1.5.0-rc01

October 26, 2022

androidx.test:runner:1.5.0-rc01 is released.

runner 1.5.0-beta02

October 21, 2022

androidx.test:runner:1.5.0-beta02 is released.

API changes

  • Denote the long standing @Beta/@ExperimentalTestApi androidx.test.runner.screenshot as stable but deprecated

Bug fixes

  • Add support for reading from TestStorage in -e testFile

runner 1.5.0-beta01

October 6, 2022

androidx.test:runner:1.5.0-beta01 is released.

API changes

  • Deprecate the '-e timeout' runtime parameter in favor of JUnit's Timeout rule.
  • Add an AbstractFilter class.

Bug fixes

  • Fix trace errors for long test names
  • Handle case where app crashes before instrumentationResultPrinter is set.

runner 1.5.0-alpha04

June 1, 2022

androidx.test:runner:1.5.0-alpha04 is released.

Bug fixes

  • Revert to javac 11 to prevent IncompatibleClassChangeErrors [#1351]

runner 1.5.0-alpha03

April 28, 2022

androidx.test:runner:1.5.0-alpha03 is released.

Bug fixes

  • Report the process crash immediately in the orchestrator instrumentation listener.

runner 1.5.0-alpha02

Mar 21, 2022

androidx.test:runner:1.5.0-alpha02 is released.

Bug Fixes

  • Ensure Trace.endSection is called before Instrumentation#finish.

runner 1.5.0-alpha01

Feb 11, 2022

androidx.test:runner:1.5.0-alpha01 is released.

API Changes

  • Add AndroidClasspathSuite and PackagePrefixClasspathSuite

New Features

  • Record android Trace spans for test lifecycle events

Bug Fixes

  • Support parameterized test names with commas and hashes.
  • Improve error handling during test discovery phase in orchestrator

Runner 1.4.1

runner 1.4.1-alpha03

Oct 4, 2021

androidx.test:runner:1.4.1-alpha03 is released.

Bug fixes

  • Reports the exception when an error is thrown out of the test executor.

runner 1.4.1-alpha02

Sept 28, 2021

androidx.test:runner:1.4.1-alpha02 is released.

API Changes

  • Replace androidx.test.annotaton.Beta references with ExperimentalTestApi

Bug fixes

  • No-op and deprecate Google Analytics

Dependency Changes

  • Update to
    • org.junit:junit:4.13.2

runner 1.4.1-alpha01

Aug 23, 2021

androidx.test:runner:1.4.1-alpha01 is released.

Bug Fixes

  • Enhance error handling in exception scenarios (app crashes, etc)

Rules 1.6.0

rules 1.6.0-alpha03

January 26, 2024

androidx.test:rules:1.6.0-alpha03 is released.

Bug Fixes

  • Remove all support for Android SDKs < 19. Minimum is API 19 (Android Kit Kat 4.4)

API Changes

  • Recommend use of UiAutomation#grantRuntimePermissions instead of GrantPermissionRule

rules 1.6.0-alpha02

November 29, 2023

androidx.test:rules:1.6.0-alpha02 is released.

Bug Fixes

  • Replace broken links to junit.org javadoc with @link.

API Changes

  • minSdkVersion is now 19, targetSdkVersion is now 34

New Features

rules 1.6.0-alpha01

March 21, 2023

androidx.test:rules:1.6.0-alpha01 is released.

Dependency changes

  • Update toandroidx.test:runner:1.6.0-alpha01
  • Update to kotlin stdlib 1.7.22
  • Major release toolchain update:
    • classes are now compiled to java8 bytecode
    • javac compiler switched to OpenJDK 11.

Rules 1.5.0

rules 1.5.0

November 8, 2022

androidx.test:rules:1.5.0 is released.

Changes since 1.4.0 include:

API Changes

  • Promote long standing @Beta/@ExperimentalTestApi GrantPermissionRule and ServiceTestRule as stable APIs
  • Promote long standing @Beta/@ExperimentalTestApi AtraceLogger and ProviderTestRule as stable but deprecated APIs

Dependency Changes

  • Update to
    • org.junit:junit:4.13.2

Rules 1.5.0

rules 1.5.0-rc01

October 26, 2022

androidx.test:rules:1.5.0-rc01 is released.

rules 1.5.0-beta01

October 21, 2022

androidx.test:rules:1.5.0-beta01 is released.

API Changes

  • Promote long standing @Beta/@ExperimentalTestApi GrantPermissionRule and ServiceTestRule as stable APIs
  • Promote long standing @Beta/@ExperimentalTestApi AtraceLogger and ProviderTestRule as stable but deprecated APIs

Rules 1.4.1

rules 1.4.1-beta01

October 6, 2022

androidx.test:rules:1.4.1-beta01 is released.

rules 1.4.1-alpha07

June 1, 2022

androidx.test:rules:1.4.1-alpha07 is released.

Bug fixes

  • Revert to javac 11 to prevent IncompatibleClassChangeErrors [#1351]

rules 1.4.1-alpha06

April 28, 2022

androidx.test:rules:1.4.1-alpha06 is released.

rules 1.4.1-alpha05

Mar 21 2022

androidx.test:rules:1.4.1-alpha05 is released.

rules 1.4.1-alpha04

Feb 11 2022

androidx.test:rules:1.4.1-alpha04 is released.

rules 1.4.1-alpha03

Oct 4, 2021

androidx.test:rules:1.4.1-alpha03 is released.

rules 1.4.1-alpha02

Sept 28, 2021

androidx.test:rules:1.4.1-alpha02 is released.

API Changes

  • Replace androidx.test.annotaton.Beta references with ExperimentalTestApi

Dependency Changes

  • Update to
    • org.junit:junit:4.13.2

rules 1.4.1-alpha01

Aug 23, 2021

androidx.test:rules:1.4.1-alpha01 is released.

No significant changes

Services 1.5.0

services 1.5.0-alpha03

January 26, 2024

androidx.test.services:test-services:1.5.0-alpha03 androidx.test.services:storage:1.5.0-alpha03 are released.

Bug Fixes

  • When files are opened for writing, TestStorage now truncates the file unless it is explicitly opened for appending. This prevents bytes from a prior write to the file from remaining at the end of the file.
  • Remove all support for Android SDKs < 19. Minimum is API 19 (Android Kit Kat 4.4)

services 1.5.0-alpha02

November 29, 2023

androidx.test.services:test-services:1.5.0-alpha02 androidx.test.services:storage:1.5.0-alpha02 are released.

Bug Fixes

  • Attempt to avoid outputting a test result summary which exceeds binder transaction limit

API Changes

  • minSdkVersion is now 19, targetSdkVersion is now 34

New Features

services 1.5.0-alpha01

March 21, 2022

androidx.test.services:test-services:1.5.0-alpha01 androidx.test.services:storage:1.5.0-alpha01 are released.

Dependency changes

  • Update to androidx.test:monitor:1.7.0-alpha01
  • Major release toolchain update:
    • classes are now compiled to java8 bytecode
    • javac compiler switched to OpenJDK 11.
    • APK is now signed with a different key and you will need to uninstal any previous orchestrator ('adb uninstall androidx.test.services')

Services 1.4.2

services 1.4.2

November 8, 2022

androidx.test.services:test-services:1.4.2 androidx.test.services:storage:1.4.2 are released.

services 1.4.2-rc01

October 26, 2022

androidx.test.services:test-services:1.4.2-rc01 androidx.test.services:storage:1.4.2-rc01 are released.

services 1.4.2-beta01

October 6, 2022

androidx.test.services:test-services:1.4.2-beta01 androidx.test.services:storage:1.4.2-beta01 are released.

services 1.4.2-alpha04

June 1, 2022

androidx.test.services:test-services:1.4.2-alpha04 androidx.test.services:storage:1.4.2-alpha04 are released.

Bug fixes

  • Revert to javac 11 to prevent IncompatibleClassChangeErrors [#1351]

services 1.4.2-alpha03

April 28, 2022

androidx.test.services:test-services:1.4.2-alpha03 androidx.test.services:storage:1.4.2-alpha03 are released.

services 1.4.2-alpha02

Mar 21, 2022

androidx.test.services:test-services:1.4.2-alpha02 androidx.test.services:storage:1.4.2-alpha02 are released.

services 1.4.2-alpha01

Feb 11, 2022

androidx.test.services:test-services:1.4.2-alpha01 androidx.test.services:storage:1.4.2-alpha01 are released.

Services 1.4.1

services 1.4.1

Dec 13, 2021

androidx.test.services:test-services:1.4.1 androidx.test.services:storage:1.4.1 are released.

The notable changes since previous 1.4.0 stable release are:

** Bug Fixes**

  • Fix execution on Android API 31 by using real uid for ToolConnection [#1042]

services 1.4.1-rc01

Nov 18, 2021

androidx.test.services:test-services:1.4.1-rc01 androidx.test.services:storage:1.4.1-rc01 are released.

services 1.4.1-beta01

Nov 8, 2021

androidx.test.services:test-services:1.4.1-beta01 androidx.test.services:storage:1.4.1-beta01 are released.

services 1.4.1-alpha03

Oct 4, 2021

androidx.test.services:test-services:1.4.1-alpha03 androidx.test.services:storage:1.4.1-alpha03 are released.

services 1.4.1-alpha02

Sept 28, 2021

androidx.test.services:test-services:1.4.1-alpha02 androidx.test.services:storage:1.4.1-alpha02 are released.

services 1.4.1-alpha01

Aug 23, 2021

androidx.test.services:test-services:1.4.1-alpha01 androidx.test.services:storage:1.4.1-alpha01 are released.

** Bug Fixes**

  • Fix execution on Android S Beta4 by using real uid for ToolConnection [#1042]

Version 1.4.0

Version 1.4.0

June 30, 2021

This is the stable release of AndroidX Test 1.4.0 + Espresso 3.4.0. It contains updates to the following libraries:

  • Core 1.4.0
  • Espresso 3.4.0
  • Intents 3.4.0
  • JUnit 1.1.3
  • Monitor 1.4.0
  • Orchestrator 1.4.0
  • Runner 1.4.0
  • Rules 1.4.0
  • Truth 1.4.0
  • Test Services 1.4.0

There are no changes since 1.4.0-rc01. Here is a summary of the changes since the 1.3.0 release:

New Features

  • Add Espresso ViewMatcher APIs for negative conditions
  • Allow unregistering Loopers from Espresso IdlingRegistry
  • Support specifying junit RunListeners via java.util.ServiceLoader
  • Introduce Espresso BoundedDiagnosingMatcher base class API that offers better error messaging, and apply it to various Espresso matchers
  • Support using UIThreadTest at the class level
  • Several utility methods added to ext.truth's LocationSubject
  • Add SparseBooleanArraySubject Truth Subject for making assertions about SparseBooleanArray

Bug Fixes

  • Improve handling for large stack traces on test failures [#729, #269]
    • Remove test runner framework related stack frames
    • Truncate stack traces to a max limit of 64KB, to avoid binder limit transaction errors
  • Add support for classpath scanning test discovery for multidex instrumentation apks on android APIs < 21.
  • Espresso: Improve error messaging when no activity is present
  • Improve Instrumentation#runOnMainSync exception error handling
  • Improve documentation for -e timeout_msec and AndroidJUnit4.
  • Send ActivityOptions to BootstrapActivity [#685]
  • Improve ViewMatchers#assertThat error messaging by enabling it to use Matcher.describeMismatch
  • Fix the missing desugar ThrowableExtension errors when using espresso remote [issuetracker.google.com/170228109]
  • Fix espresso web on < Android API 19 by including the androidx.test.espresso.web.bridge classes
  • Unregister ActivityResultWaiter in InstrumentationActivityInvoker if it wasn't already unregistered
  • Runner: Reduce TestEventClient 'not primary instr' log message to a warning, as its an expected condition in multi process tests
  • Espresso: Update HasSiblingMatcher to only check siblings (not self)
  • Fix artifact name for espresso.idling.resource [#809]
  • Expose setMasterPolicyTimeoutWhenDebuggerAttached functionality [#814]
  • Remove overly verbose ActivityLifecycleMonitorImpl callback logging.

Dependency Changes

  • Update espresso.accessibility and espresso.contrib to depend on the androidx-compatible com.google.android.apps.common.testing.accessibility.framework:accessibility-test-framework:3.1. This release will thus require java8 source/target compatiblity. [#492]

Known Issues

  • Using orchestrator on APIS 30+ requires Studio/AGP 4.2+

Version 1.4.0-rc01

June 21, 2021

This is a release candidate of AndroidX Test 1.4.0/Espresso 3.4.0. APIs are stable. It contains updates to the following libraries:

  • Core 1.4.0-rc01
  • Espresso 3.4.0-rc01
  • Intents 3.4.0-rc01
  • JUnit 1.1.3-rc01
  • Monitor 1.4.0-rc01
  • Orchestrator 1.4.0-rc01
  • Runner 1.4.0-rc01
  • Rules 1.4.0-rc01
  • Truth 1.4.0-rc01
  • Test Services 1.4.0-rc01

This release candidate is equivalent to the 1.4.0-beta02/3.4.0-beta02 release, aside from the version number.

Version 1.4.0-beta02

June 7, 2021

This is a beta release of AndroidX Test 1.4.0. APIs are not expected to change. It contains updates to the following libraries:

  • Core 1.4.0-beta02
  • Espresso 3.4.0-beta02
  • Intents 3.4.0-beta02
  • JUnit 1.1.3-beta02
  • Monitor 1.4.0-beta02
  • Orchestrator 1.4.0-beta02
  • Runner 1.4.0-beta02
  • Rules 1.4.0-beta02
  • Truth 1.4.0-beta02
  • Test Services 1.4.0-beta02

Here is a summary of the changes since the 1.4.0-beta01 release:

Bug fixes

  • Switch back to classic desugaring to address backwards compatiblity and core-library desugaring issues with beta-1 [Fixes #968 ]

Version 1.4.0-beta01

May 17, 2021

This is the beta release of AndroidX Test 1.4.0. APIs are not expected to change. It contains updates to the following libraries:

  • Core 1.4.0-beta01
  • Espresso 3.4.0-beta01
  • Intents 3.4.0-beta01
  • JUnit 1.1.3-beta01
  • Monitor 1.4.0-beta01
  • Orchestrator 1.4.0-beta01
  • Runner 1.4.0-beta01
  • Rules 1.4.0-beta01
  • Truth 1.4.0-beta01
  • Test Services 1.4.0-beta01

Here is a summary of the changes since the 1.4.0-alpha06 release:

New API cleanup

  • Remove InstrumentationProvider
  • Undeprecate BoundedMatcher
  • Restore CursorMatcher to inherit from BoundedMatcher

Version 1.4.0-alpha06

April 29, 2021

This is the alpha release of AndroidX Test 1.4.0. New APIs are subject to change. It contains updates to the following libraries:

  • Core 1.4.0-alpha06
  • Espresso 3.4.0-alpha06
  • Intents 3.4.0-alpha06
  • JUnit 1.1.3-alpha06
  • Monitor 1.4.0-alpha06
  • Orchestrator 1.4.0-alpha06
  • Runner 1.4.0-alpha06
  • Rules 1.4.0-alpha06
  • Truth 1.4.0-alpha06
  • Test Services 1.4.0-alpha06

Here is a summary of the changes since the 1.4.0-alpha05 release:

Bug Fixes

  • Support compiling against SDKS < 29 by removing forceQueryable from manifest [#917]

Version 1.4.0-alpha05

March 15, 2021

This is the alpha release of AndroidX Test 1.4.0. New APIs are subject to change. It contains updates to the following libraries:

  • Core 1.4.0-alpha05
  • Espresso 3.4.0-alpha05
  • Intents 3.4.0-alpha05
  • JUnit 1.1.3-alpha05
  • Monitor 1.4.0-alpha05
  • Orchestrator 1.4.0-alpha05
  • Runner 1.4.0-alpha05
  • Rules 1.4.0-alpha05
  • Truth 1.4.0-alpha05
  • Test Services 1.4.0-alpha05

Here is a summary of the changes since the 1.4.0-alpha04 release:

API Changes

  • [Truth] Add SparseBooleanArraySubject Truth Subject for making assertions about SparseBooleanArray.

Bug Fixes

  • Add QUERY_ALL_PACKAGES permission to the Android Test Orchestrator and Android Test Services APK to work properly on Android API R+.
  • Add support for classpath scanning test discovery for multidex instrumentation apks on android APIs < 21.

Version 1.4.0-alpha04

February 8, 2021

This is the alpha release of AndroidX Test 1.4.0. New APIs are subject to change. It contains updates to the following libraries:

  • Core 1.4.0-alpha04
  • Espresso 3.4.0-alpha04
  • Intents 3.4.0-alpha04
  • JUnit 1.1.3-alpha04
  • Monitor 1.4.0-alpha04
  • Orchestrator 1.4.0-alpha04
  • Runner 1.4.0-alpha04
  • Rules 1.4.0-alpha04
  • Truth 1.4.0-alpha04
  • Test Services 1.4.0-alpha04

Here is a summary of the changes since the 1.3.1-alpha03 release:

New Features

  • [Espresso] Improve error messaging for various Espresso assertions
  • [Truth] Several utility methods added to LocationSubject

API Changes

  • Added InstrumentationRegistry.registerInstrumentationProvider

Bug Fixes

  • Remove overly verbose ActivityLifecycleMonitorImpl callback logging.

Dependency Changes

Version 1.3.1

Version 1.3.1-alpha03

January 11, 2021

This is the alpha release of AndroidX Test 1.3.1. New APIs are subject to change. It contains updates to the following libraries:

  • Core 1.3.1-alpha03
  • Espresso 3.4.0-alpha03
  • Intents 3.4.0-alpha03
  • JUnit 1.1.3-alpha03
  • Monitor 1.3.1-alpha03
  • Orchestrator 1.3.1-alpha03
  • Runner 1.3.1-alpha03
  • Rules 1.3.1-alpha03
  • Truth 1.3.1-alpha03
  • Test Services 1.3.1-alpha03

Here is a summary of the changes since the 1.3.1-alpha02 release:

New Features

  • Support using UIThreadTest at the class level

Bug Fixes

  • Unregister ActivityResultWaiter in InstrumentationActivityInvoker if it wasn't already unregistered
  • Runner: Reduce TestEventClient 'not primary instr' log message to a warning, as its an expected condition in multi process tests
  • Espresso: Update HasSiblingMatcher to only check siblings (not self).
  • Fix artifact name for espresso.idling.resource [#809]
  • Expose setMasterPolicyTimeoutWhenDebuggerAttached functionality [#814]

Dependency Changes

  • Update espresso.accessibility and espresso.contrib to depend on the androidx-compatible com.google.android.apps.common.testing.accessibility.framework:accessibility-test-framework:3.1. This release will thus require java8 source/target compatiblity. [#492]

Version 1.3.1-alpha02

October 20, 2020

This is the alpha release of AndroidX Test 1.3.1. New APIs are subject to change. It contains updates to the following libraries:

  • Core 1.3.1-alpha02
  • Espresso 3.4.0-alpha02
  • Intents 3.4.0-alpha02
  • JUnit 1.1.3-alpha02
  • Monitor 1.3.1-alpha02
  • Orchestrator 1.3.1-alpha02
  • Runner 1.3.1-alpha02
  • Rules 1.3.1-alpha02
  • Truth 1.3.1-alpha02
  • Test Services 1.3.1-alpha02

Here is a summary of the changes since the 1.3.1-alpha01 release:

New Features

  • Early look at new Espresso BoundedDiagnosingMatcher base class API that offers better error messaging.

Bug Fixes

  • Fix orchestrator clearPackageData on API 30 [#743]

Version 1.3.1-alpha01

October 15, 2020

This is the alpha release of AndroidX Test 1.3.1. New APIs are subject to change. It contains updates to the following libraries:

  • Core 1.3.1-alpha01
  • Espresso 3.4.0-alpha01
  • Intents 3.4.0-alpha01
  • JUnit 1.1.3-alpha01
  • Monitor 1.3.1-alpha01
  • Orchestrator 1.3.1-alpha01
  • Runner 1.3.1-alpha01
  • Rules 1.3.1-alpha01
  • Truth 1.3.1-alpha01
  • Test Services 1.3.1-alpha01

Here is a summary of the changes since the 1.3.0 release:

New Features

  • Add Espresso ViewMatcher APIs for negative conditions
  • Allow unregistering Loopers from Espresso IdlingRegistry
  • Support specifying junit RunListeners via java.util.ServiceLoader

Bug Fixes

  • Improve handling for large stack traces on test failures [#729, #269]
    • Remove test runner framework related stack frames
    • Truncate stack traces to a max limit of 64KB, to avoid binder limit transaction errors
  • Espresso: Improve error messaging when no activity is present
  • Improve Instrumentation#runOnMainSync exception error handling
  • Add package visibility entries for Orchestrator and Services to fix Orchestator when using targetSdk 30 [#743]
  • Improve documentation for -e timeout_msec and AndroidJUnit4.
  • Send ActivityOptions to BootstrapActivity [#685]
  • Improve ViewMatchers#assertThat error messaging by enabling it to use Matcher.describeMismatch
  • Fix the missing desugar ThrowableExtension errors when using espresso remote [issuetracker.google.com/170228109]
  • Fix espresso web on < Android API 19 by including the androidx.test.espresso.web.bridge classes

Version 1.3.0

Version 1.3.0

August 25, 2020

This is the stable release of AndroidX Test 1.3.0. It contains updates to the following libraries:

  • Core 1.3.0
  • Espresso 3.3.0
  • Intents 3.3.0
  • JUnit 1.1.2
  • Monitor 1.3.0
  • Orchestrator 1.3.0
  • Runner 1.3.0
  • Rules 1.3.0
  • Truth 1.3.0
  • Test Services 1.3.0

There are no changes since 1.3.0-rc03. Here is a summary of the changes since the 1.2.0 release:

New Features

  • Support filtering by prerelease SDKs via SdkSuppress#codeName
  • Add truth extensions for Location
  • Add truth assertions for Bundle string and parceable arrays.
  • Support ActivityOptions in ActivityScenario
  • Make activity lifecycle transition timeout configurable
  • Handle Activities launched via implicit intents. (Fixes #496)
  • Add a BundleMatchers.isEmpty() and isEmptyOrNull() methods
  • Allow Intents.release without Intents.init
  • Add ViewMatchers.isFocused()

API Changes

  • ActivityTestRule is deprecated in favor of ActivityScenario/ActivityScenarioRule
  • Allow subclasses of ServiceTestRule to customize timeout

Bug Fixes

  • Fix filtering parameterized methods
    • This also fixes running parameterized tests with Orchestrator [#215, https://issuetracker.google.com/119838413]
  • Fix 'runtime permission dialog appears' when running on API 29
  • Skip starting and finish animations for the empty activity used in ActivityScenario. (Fixes #411)
  • Handle Activities launched via implicit intents. (Fixes #496)
  • Make kotlin package names unique, fixing log spam when building with AGP 4.1 [#680]
  • Only delegate to RobolectricTestRunner in AndroidJUnit4 runner if its on the classpath
  • Espresso contrib: Replace usages of RecyclerView.findViewHolderForPosition method with its replacement
  • Fix NoSuchMethodError when testing with AccessibilityChecks enabled (#376)
  • Fix the error message when Espresso is busy due to processing messages rather than idling resources
  • ViewMatchers.isDisplayingAtLeast() works for views with negative scale.
  • Enhance error messaging for WithIdMatcher
  • Remove spurious wait in waitForAtLeastOneActivityToBeResumed.
  • Set correct meta state for ACTION_UP
  • Fix missing missing androidx_test_espresso_contrib_drawer_layout_tag field [#671]
  • Improve class path scanning error handling in AndroidJUnitRunner: Ignore all no class found and linkage errors (Fixes #439)
  • Initialize InstrumentationRegistry before creating RunListeners from RunnerArgs

Dependency Changes

  • Truth: Update to com.google.truth:truth:1.0 and com.google.guava:guava:27.0.1-android

Version 1.3.0-rc03

August 5, 2020

This is the third release candidate of AndroidX Test 1.3.0. It contains updates to the following libraries:

  • Core 1.3.0-rc03
  • Espresso 3.3.0-rc03
    • Remove some not-yet-ready-for-release APIs that were mistakenly included in previous rc+beta builds
  • Intents 3.3.0-rc03
    • Remove some not-yet-ready-for-release APIs that were mistakenly included in previous rc+beta builds
  • JUnit 1.1.2-rc03
  • Monitor 1.3.0-rc03
  • Orchestrator 1.3.0-rc03
  • Runner 1.3.0-rc03
  • Rules 1.3.0-rc03
  • Truth 1.3.0-rc03
  • Test Services 1.3.0-rc03

Version 1.3.0-rc02

July 28, 2020

This is the second release candidate of AndroidX Test 1.3.0. It contains updates to the following libraries:

  • Core 1.3.0-rc02
    • Make kotlin package names unique, fixing log spam when building with AGP 4.1 [#680]
  • Espresso 3.3.0-rc02
    • Fix missing missing androidx_test_espresso_contrib_drawer_layout_tag field [#671]
  • Intents 3.3.0-rc02
  • JUnit 1.1.2-rc02
  • Monitor 1.3.0-rc02
  • Orchestrator 1.3.0-rc02
  • Runner 1.3.0-rc02
  • Rules 1.3.0-rc02
    • Add conversion tips for ActivityTestRule->ActivityScenario
  • Truth 1.3.0-rc02
  • Test Services 1.3.0-rc02

Version 1.3.0-rc01

May 28, 2020

This is a release candidate of AndroidX Test 1.3.0. It contains updates to the following libraries:

  • Core 1.3.0-rc01
  • Espresso 3.3.0-rc01
    • Make package names unique, fixing log spam when building with AGP 4.1 [#573]
  • Intents 3.3.0-rc01
  • JUnit 1.1.2-rc01
  • Monitor 1.3.0-rc01
    • Make package names unique, fixing log spam when building with AGP 4.1 [#573]
  • Orchestrator 1.3.0-rc01
  • Runner 1.3.0-beta01
    • Make package names unique, fixing log spam when building with AGP 4.1 [#573]
  • Rules 1.3.0-rc01
    • Make package names unique, fixing log spam when building with AGP 4.1 [#573]
  • Truth 1.3.0-rc01
  • Test Services 1.3.0-rc01

Version 1.3.0-beta02

May 20, 2020

This is a beta release of AndroidX Test 1.3.0. New APIs are unlikely to change. It contains updates to the following libraries:

  • Core 1.3.0-beta02
  • Espresso 3.3.0-beta02
  • Intents 3.3.0-beta02
  • JUnit 1.1.2-beta02
  • Monitor 1.3.0-beta02
  • Orchestrator 1.3.0-beta02
  • Runner 1.3.0-beta01
    • Fix running parameterized tests with Orchestrator [#215, https://issuetracker.google.com/119838413]
  • Rules 1.3.0-beta02
  • Truth 1.3.0-beta02
  • Test Services 1.3.0-beta02
    • Fix 'runtime permission dialog appears' when running on API 29

Version 1.3.0-beta01

April 20, 2020

This is a beta release of AndroidX Test 1.3.0. New APIs are unlikely to change. It contains updates to the following libraries:

  • Core 1.3.0-beta01
  • Espresso 3.3.0-beta01
    • Add ViewMatchers.isFocused()
    • Enhance error messaging for WithIdMatcher
  • Intents 3.3.0-beta01
    • Allow Intents.release without Intents.init
  • JUnit 1.1.2-beta01
  • Monitor 1.3.0-beta01
  • Orchestrator 1.3.0-beta01
  • Runner 1.3.0-beta01
    • Only delegate to RobolectricTestRunner if its on the classpath
    • Support filtering by prerelease SDKs via SdkSuppress#codeName
  • Rules 1.3.0-beta01
    • Deprecate ActivityTestRule
  • Truth 1.3.0-beta01
    • Make LocationSubject override isEqualTo
  • Test Services 1.3.0-beta01

Version 1.3.0-alpha05

March 17, 2020

This is an alpha release of AndroidX Test 1.3.0. New APIs are subject to change. It contains updates to the following libraries:

  • Core 1.3.0-alpha05
    • Skip starting and finish animations for the empty activity used in ActivityScenario. (Fixes #411)
    • Handle Activities launched via implicit intents. (Fixes #496)
  • Espresso 3.3.0-alpha05
    • ViewMatchers.isDisplayingAtLeast() works for views with negative scale.
    • Remove spurious wait in waitForAtLeastOneActivityToBeResumed.
    • Set correct meta state for ACTION_UP
  • Intents 3.3.0-alpha05
  • JUnit 1.1.2-alpha05
  • Monitor 1.3.0-alpha05
  • Orchestrator 1.3.0-alpha05
  • Runner 1.3.0-alpha05
    • Ignore all LinkageError exceptions when scanning classpath for tests. (Fixes #439)
    • Initialize InstrumentationRegistry before creating RunListeners from RunnerArgs
  • Rules 1.3.0-alpha05
  • Truth 1.3.0-alpha05
  • Test Services 1.3.0-alpha05

Version 1.3.0-alpha04

February 20, 2020

This is an alpha release of AndroidX Test 1.3.0. New APIs are subject to change. It contains updates to the following libraries:

  • Core 1.3.0-alpha04
  • Espresso 3.3.0-alpha04
    • Fix the error message when Espresso is busy due to processing messages rather than idling resources
  • Intents 3.3.0-alpha04
  • JUnit 1.1.2-alpha04
  • Monitor 1.3.0-alpha04
  • Orchestrator 1.3.0-alpha04
  • Runner 1.3.0-alpha04
    • Fix AndroidJUnitRunner to report a test as failure if a StrictMode violation occurs
    • Add additional info when JUnit4 test class is malformed for easier diagnostics
  • Rules 1.3.0-alpha04
  • Truth 1.3.0-alpha04
  • Test Services 1.3.0-alpha04
    • Include the test storage service in the test services

Here's a full list of commits contained in version 1.3.0-alpha04.

Version 1.3.0-alpha03

December 3, 2019

This is an alpha release of AndroidX Test 1.3.0. New APIs are subject to change. It contains updates to the following libraries:

  • Core 1.3.0-alpha03
    • Support ActivityOptions in ActivityScenario
  • Espresso 3.3.0-alpha03
    • Fix NoSuchMethodError when testing with AccessibilityChecks enabled (#376)
  • Intents 3.3.0-alpha03
  • JUnit 1.1.2-alpha03
  • Monitor 1.3.0-alpha03
  • Orchestrator 1.3.0-alpha03
  • Runner 1.3.0-alpha03
    • Ignore NoClassDefFoundErrors when performing classpath scanning for tests
    • Add better error handling on unhandled exceptions
    • Allowing opting out of 'waitForActivitiesToComplete' via a runner argument
  • Rules 1.3.0-alpha03
  • Truth 1.3.0-alpha03
    • Update Location extensions to behave better with nulls.
    • Add stringArrayList and parcelableArrayList methods to BundleSubject

Version 1.2.1

Version 1.2.1-alpha02

July 15, 2019

This is an alpha release of AndroidX Test 1.2.1. New APIs are subject to change. It contains updates to the following libraries:

  • Core 1.2.1-alpha02
    • Make activity lifecycle transition timeout configurable
  • Espresso 3.3.0-alpha02
  • Intents 3.3.0-alpha02
    • Add a BundleMatchers.isEmpty() and isEmptyOrNull() methods
  • JUnit 1.1.2-alpha02
  • Monitor 1.3.0-alpha02
  • Orchestrator 1.3.0-alpha02
  • Runner 1.3.0-alpha02
  • Rules 1.3.0-alpha02
  • Truth 1.3.0-alpha02
    • Update to com.google.truth:truth:1.0 and com.google.guava:guava:27.0.1-android

Version 1.2.1-alpha01

June 17, 2019

This is an alpha release of AndroidX Test 1.2.1. New APIs are subject to change. It contains updates to the following libraries:

  • Core 1.2.1-alpha01
    • Includes toolchain fix for 'Invalid parameter counts in MethodParameter attributes' build warning
  • Espresso 3.3.0-alpha01
    • contrib: Replace usages of RecyclerView.findViewHolderForPosition method with its replacement
  • Intents 3.3.0-alpha01
  • JUnit 1.1.2-alpha01
  • Monitor 1.3.0-alpha01
  • Orchestrator 1.3.0-alpha01
  • Runner 1.3.0-alpha01
  • Rules 1.3.0-alpha01
    • Allow subclasses of ServiceTestRule to customize timeout
  • Truth 1.3.0-alpha01
    • Add truth extensions for Location

Version 1.2.0

Version 1.2.0

May 29, 2019

This is the stable release of AndroidX Test 1.2.0. It contains updates to the following libraries:

  • Core 1.2.0
  • Espresso 3.2.0
  • Intents 3.2.0
  • JUnit 1.1.1
  • Monitor 1.2.0
  • Orchestrator 1.2.0
  • Runner 1.2.0
  • Rules 1.2.0
  • Truth 1.2.0

Version 1.2.0-beta01

May 6, 2019

This is an beta release of AndroidX Test 1.2.0. It contains updates to the following libraries:

  • Core 1.2.0-beta01
    • More gracefully handle situations where multiple ActivityScenarios are used in a test
  • Espresso 3.2.0-beta01
  • Intents 3.2.0-beta01
  • JUnit 1.1.1-beta01
  • Monitor 1.2.0-beta01
    • Instrumentation.runOnMainSync() propogates exceptions back to calling thread
  • Orchestrator 1.2.0-beta01
  • Runner 1.2.0-beta01
  • Rules 1.2.0-beta01
  • Truth 1.2.0-beta01

Version 1.2.0-alpha05

April 30, 2019

This is an alpha release of AndroidX Test 1.2.0. New APIs are subject to change. It contains updates to the following libraries:

  • Core 1.2.0-alpha05
    • Make ActivityScenario#onActivity callable from the main thread
  • Espresso 3.2.0-alpha05
    • More deflaking of openActionBarOverflowOrOptionsMenu
  • Intents 3.2.0-alpha05
  • JUnit 1.1.1-alpha05
  • Monitor 1.2.0-alpha05
  • Orchestrator 1.2.0-alpha05
  • Runner 1.2.0-alpha05
  • Rules 1.2.0-alpha05
  • Truth 1.2.0-alpha05
    • update to upstream google Truth 0.44

Version 1.2.0-alpha04

April 18, 2019

This is an alpha release of AndroidX Test 1.2.0. New APIs are subject to change. It contains updates to the following libraries:

  • Core 1.2.0-alpha04
  • Espresso 3.2.0-alpha04
    • Deflake openActionBarOverflowOrOptionsMenu
    • Add hook in androidx.test to simulate a window focus changed for local test environments
  • Intents 3.2.0-alpha04
  • JUnit 1.1.1-alpha04
  • Monitor 1.2.0-alpha04
  • Orchestrator 1.2.0-alpha04
  • Runner 1.2.0-alpha04
    • Make androidx.test work if legacy android.test classes are not present
  • Rules 1.2.0-alpha04
  • Truth 1.2.0-alpha04

Version 1.2.0-alpha03

April 7, 2019

This is an alpha release of AndroidX Test 1.2.0. New APIs are subject to change. It contains updates to the following libraries:

  • Core 1.2.0-alpha03
    • Add getState() API to ActivityScenario
  • Espresso 3.2.0-alpha03
    • Convert WithTagKeyMatcher to accept Matcher<?> instead of Matcher
    • Update link to espresso setup docs
    • Fix debug logging when running in different locales
  • Intents 3.2.0-alpha03
  • JUnit 1.1.1-alpha03
  • Monitor 1.2.0-alpha03
    • Another attempt at clearing exception handler to prevent memory leaks in Robolectric.
  • Orchestrator 1.2.0-alpha03
  • Runner 1.2.0-alpha03
    • Add a tests_regex AJUR option to run tests matching a given regular expression.
  • Rules 1.2.0-alpha03
  • Truth 1.2.0-alpha03
    • Expose the ParcelableSubject API
    • Add BundleSubject#longInt
    • Add IntentSubject#hasComponent

Version 1.1.1

Version 1.1.1-alpha02

March 7, 2019

This is an alpha release of AndroidX Test 1.1.1. New APIs are subject to change. It contains updates to the following libraries:

  • Espresso 3.2.0-alpha02
  • Intents 3.2.0-alpha02
    • Add IntentMatchers#filterEquals
    • Fix activity lifecycle timing bug in Intents#intended(). It now idles main looper before checking activity state.
  • Runner 1.1.2-alpha02
    • Allow specifying both package and class filters.
  • Truth 1.2.0-alpha02
  • JUnit 1.1.1-alpha02
  • Core 1.1.1-alpha02
    • Throw a RuntimeException when Activity cannot be resolved.
  • Monitor 1.1.2-alpha02
    • Clear reference to uncaught exception handler to prevent memory leaks in Robolectric.
  • Rules 1.1.2-alpha02
  • Orchestrator 1.1.2-alpha02

Version 1.1.1-alpha01

January 30, 2019

This is an alpha release of AndroidX Test 1.1.1. New APIs are subject to change. It contains updates to the following libraries:

  • Espresso 3.1.2-alpha01
    • Added method AccessibilityChecks.disable().
  • Intents 3.1.2-alpha01
    • Add IntentMatchers#hasDataString
    • Fix activity lifecycle timing bug in Intents#intended(). It now idles main looper before checking activity state.
  • Runner 1.1.2-alpha01
    • AndroidJUnitRunner now accepts comma separated class list in -e annotation option, for running only tests with all of the given annotations
  • Truth 1.1.1-alpha01
    • Add filtersEquallyTo() to IntentSubject for comparison of intents using Intent.filterEquals().
  • JUnit 1.1.1-alpha01
  • Core 1.1.1-alpha01
  • Monitor 1.1.2-alpha01
  • Rules 1.1.2-alpha01
  • Orchestrator 1.1.2-alpha01

Version 1.1.0

Version 1.1.0

December 13, 2018

This is the stable release of AndroidX Test 1.1.0. It contains updates to the following libraries:

  • Espresso 3.1.1
  • Runner 1.1.1
  • Rules 1.1.1
  • Monitor 1.1.
  • AndroidTestOrchestrator 1.1.1
  • Core 1.1.0
  • Truth 1.1.0
  • JUnit 1.1.0

  • Core 1.1.0

    • Make ActivityScenario support activities which start another activity

Version 1.1.0-beta01

December 6, 2018

This is the beta01 release of AndroidX Test 1.1.0. It contains updates to the following libraries:

  • Core 1.1.0-beta01
    • New core-ktx kotlin extension artifact! Includes a kotlin-friendly ActivityScenario.launchActivity API
    • New ActivityScenario API for launching activities with custom intents
    • New ActivityScenario API for receiving an Activity result
    • Make ActivityScenario closeable
  • Espresso3.1.1-beta01
    • Modify withResourceNameMatcher and HumanReadables to be API 28 compatible.
    • Update ReplaceTextAction's description to include the stringToBeSet
    • Support Espresso in Robolectric paused looper mode.
  • JUnit 1.1.0-beta01
    • New ActivityScenarioRule API, for auto-launching and closing an Activity on test setup and teardown
    • New junit-ktx kotlin extension artifact! Includes a kotlin-friendly ActivityScenarioRule API
  • Runner 1.1.1-beta01
    • Make -e package and -e testFile consistent in behavior when receiving packages
  • Truth 1.1.0-beta01
    • Add bool, parcelable, and parcelableAsType BundleSubject APIs
  • Rules 1.1.1-beta01
  • Monitor 1.1.1-beta01
  • AndroidTestOrchestrator 1.1.1-beta01

Version 1.0.0

Version 1.0.0

October 24, 2018

  • All libraries
    • Set minSdkVersion to 14 and targetSdkVersion to 28
  • Espresso 3.1.0
    • Fix withContentDescription to work with non-string types
    • Add support for using Espresso on Robolectric
    • Issue 73044169: Espresso ViewMatchers.withText doesn't work when textAllCaps is enabled
    • Add support for injecting a sequence of motion events
  • Intents
    • Add beta API for retrieving list of intents. Intended for use with new truth assertions
  • Runner 1.1.0
    • Add support for instant apps
    • Deprecate androidx.test.runner.AndroidJUnit4 and replace with androidx.test.ext.junit.runners.AndroidJUnit4
  • Monitor 1.1.0
    • Deprecate androidx.test.InstrumentationRegistry and replace with androidx.test.platform.app.InstrumentationRegistry and androidx.test.core.app.ApplicationProvider
  • AndroidTestOrchestrator 1.1.0
    • Only enable orchestrator coverage handling if both 'coverage' and 'coverageFilePath' arguments are passed.
    • Only wait for debugger when the -debug is set but not for listing ATO test cases. A new orchestratorDebug flag was added for debugging orchestrator itself
  • Core 1.0.0
    • New artifact! Includes new APIs that support both local and on-device tests for:
      • Retrieving context: ApplicationProvider
      • Controlling activity lifecycles: ActivityScenario(beta)
      • Builders for MotionEvent, PackageInfo
      • Parceables utility class
  • Truth 1.0.0
    • New artifact! Includes custom truth subjects for Notification, Intent, Bundle, Parcelable, and MotionEvent
  • JUnit 1.0.0
    • New artifact! Includes JUnit runner class androidx.test.ext.junit.runners.AndroidJUnit4 that supports both local and on-device tests.