Need help with testing-samples?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

8.2K Stars 3.4K Forks Apache License 2.0 379 Commits 101 Opened issues


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

Services available


Need anything else?

Contributors list

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

entry point for Espresso, for lists and AdapterViews

FragmentScenarioSample - Basic usage of

with Espresso.

IdlingResourceSample - Synchronization with background jobs

IntentsBasicSample - Basic usage of


IntentsAdvancedSample - Simulates a user fetching a bitmap using the camera

MultiWindowSample - Shows how to point Espresso to different windows

RecyclerViewSample - RecyclerView actions for Espresso

ScreenshotSample - Screenshot capturing and saving using Espresso and androidx.test.core APIs

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


IntentsBasicSample - Simple usage of


ServiceTestRuleSample - Simple usage of



  • 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

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 for more information.

Experimental Bazel Support

Build status

Some of these samples can be tested with Bazel on Linux. These samples contain a

file, which is similar to a
file. The external dependencies are defined in the top level

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

# Clone the repository if you haven't.
$ git clone
$ cd android-testing

Edit the path to your local SDK at the top of the WORKSPACE file


Test everything in a headless mode (no graphical display)

$ bazel test //... --config=headless

Test a single test, e.g. ui/espresso/BasicSample/BUILD.bazel

$ bazel test //ui/uiautomator/BasicSample:BasicSampleInstrumentationTest_21_x86 --config=headless

Query for all android_instrumentation_test targets

$ bazel query 'kind(android_instrumentation_test, //...)' //ui/uiautomator/BasicSample:BasicSampleInstrumentationTest_23_x86 //ui/uiautomator/BasicSample:BasicSampleInstrumentationTest_22_x86 //ui/uiautomator/BasicSample:BasicSampleInstrumentationTest_21_x86 //ui/uiautomator/BasicSample:BasicSampleInstrumentationTest_19_x86 //ui/espresso/RecyclerViewSample:RecyclerViewSampleInstrumentationTest_23_x86 //ui/espresso/RecyclerViewSample:RecyclerViewSampleInstrumentationTest_22_x86 //ui/espresso/RecyclerViewSample:RecyclerViewSampleInstrumentationTest_21_x86 //ui/espresso/RecyclerViewSample:RecyclerViewSampleInstrumentationTest_19_x86 //ui/espresso/MultiWindowSample:MultiWindowSampleInstrumentationTest_23_x86 //ui/espresso/MultiWindowSample:MultiWindowSampleInstrumentationTest_22_x86 ...

Test everything with GUI enabled

$ bazel test //... --config=gui

Test with a local device or emulator. Ensure that adb devices lists the device.

$ bazel test //... --config=local_device

If multiple devices are connected, add --device_serial_number=$identifier where $identifier is the name of the device in adb devices

$ bazel test //... --config=local_device --test_arg=--device_serial_number=$identifier

For more information, check out the documentation for Android Instrumentation Tests in Bazel. You may also want to check out Building an Android App with Bazel, and the list of Android Rules in the Bazel Build Encyclopedia.

Known issues:

  • Building of APKs is supported on Linux, Mac and Windows, but testing is only supported on Linux.
  • android_instrumentation_test.target_device
    attribute still needs to be specified even if
    is used.
  • If using a local device or emulator, the APKs are not uninstalled automatically after the test. Use this command to remove the packages:
    • adb shell pm list packages | cut -d ':' -f 2 | tr -d '\r' | xargs -L1 -t adb uninstall

Please file Bazel related issues against the Bazel repository instead of this repository.


  • Google+ Community:
  • Stack Overflow:

If you've found an error in this sample, please file an issue:

Patches are encouraged, and may be submitted by forking this project and submitting a pull request through GitHub. Please see for more details.


Copyright 2015 The Android Open Source Project, Inc.

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.