README.md

device-automator

Device Automator is an Android library built on top of the UI Automator testing framework. Device Automator provides an easy to use syntax for writing UI Automator tests that interact across apps and the device itself. The Device Automator API very closely resembles the Espresso API and similarly encourages test authors to think in terms of what a user might do while interacting with the application - locating UI elements and interacting with them.

Setup

Download device-automator

Add the dependency in your build.gradle file:

dependencies {
  androidTestCompile 'com.lukekorth:device-automator:1.1.0'
}

To use the latest build from the master branch use:

dependencies {
  androidTestCompile 'com.lukekorth:device-automator:1.1.0-SNAPSHOT'
}

Set the instrumentation runner

Add the following line to your build.gradle file in android.defaultConfig:

testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"

Writing Tests

It's recommended that you start every test from your device's home screen. To do that, run the following before each test:

onDevice().onHomeScreen();

To launch an app, call:

onDevice().launchApp("com.myapp.package");

To click on a view:

onDevice(withText("My Button")).perform(click());

To type text:

onDevice(withText("Enter text here")).perform(setText("foobar"));

To make assertions after interacting:

onDevice(withContentDescription("message field")).check(text(containsString("my message")));