Android testing samples

A collection of samples demonstrating different frameworks and techniques for automated testing.

Espresso Samples

BasicSample - Basic Espresso sample

CustomMatcherSample - Shows how to extend Espresso to match the hint property of an EditText

DataAdapterSample - Showcases the onData() entry point for Espresso, for lists and AdapterViews

FragmentScenarioSample - Basic usage of FragmentScenario with Espresso.

IdlingResourceSample - Synchronization with background jobs

IntentsBasicSample - Basic usage of intended() and intending()

IntentsAdvancedSample - Simulates a user fetching a bitmap using the camera

MultiWindowSample - Shows how to point Espresso to different windows

RecyclerViewSample - RecyclerView actions for Espresso

WebBasicSample - Use Espresso-web to interact with WebViews

BasicSampleBundled - Basic sample for Eclipse and other IDEs

MultiProcessSample - Showcases how to use multiprocess Espresso.

UiAutomator Sample

BasicSample - Basic UI Automator sample

AndroidJUnitRunner Sample

AndroidJunitRunnerSample - Showcases test annotations, parameterized tests and testsuite creation

JUnit4 Rules Sample

**All previous samples use ActivityTestRule or IntentsTestRule but there's one specific to ServiceTestRule:

BasicSample - Simple usage of ActivityTestRule

IntentsBasicSample - Simple usage of IntentsTestRule

ServiceTestRuleSample - Simple usage of ServiceTestRule

Prerequisites

• Android SDK v28
• Android Build Tools v28.03

Getting Started

These samples use the Gradle build system. To build a project, enter the project directory and use the ./gradlew assemble command or use "Import Project" in Android Studio.

• Use ./gradlew connectedAndroidTest to run the tests on a connected emulator or device.
• Use ./gradlew test to run the unit test on your local host.

There is a top-level build.gradle file if you want to build and test all samples from the root directory. This is mostly helpful to build on a CI (Continuous Integration) server.

AndroidX Test Library

Many of these samples use the AndroidX Test Library. Visit the Testing site on developer.android.com for more information.

Experimental Bazel Support

Some of these samples can be tested with Bazel on Linux. These samples contain a BUILD.bazel file, which is similar to a build.gradle file. The external dependencies are defined in the top level WORKSPACE file.

This is experimental feature. To run the tests, please install the latest version of Bazel (0.12.0 or later) by following the instructions on the Bazel website.

Bazel commands