A sample project for Cucumber and Espresso in Android
Alternatives To Cucumberespressodemo
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Green Coffee218
2 years ago1mitJava
Android library that allows you to run your acceptance tests written in Gherkin in your Android instrumentation tests.
6 years ago5mitJava
Sample project of Android GUI test automation using Espresso, Cucumber and the Page Object Pattern
4 years agomitJava
A sample project for Cucumber and Espresso in Android
3 years ago2apache-2.0Java
Android project to experiment various testing tools
Espresso Cucumber47
8 years ago1apache-2.0Java
Library to test Android applications using Espresso test framework with cucumber BDD language and Spoon screenshots
4 years ago3apache-2.0Java
Android BDD Espresso + Cucumber
Android Cucumber Espresso12
7 years agoJava
A template project to demonstrate the usage of Cucumber along with Espresso for acceptance testing on Android.
7 years agoJava
Workshop Android Espresso with Cucumber jvm
No Cucumber1
5 years agoKotlin
A toolset for making your manager happy and staying sane at the same time
Alternatives To Cucumberespressodemo
Select To Compare

Alternative Project Comparisons


Cucumber is BDD framework which works for iOS, Android and more. For Android, we are going to use cucumber-jvm, java port of cucumber.

BDD's behavior text is written in a business-readable domain-specific language. It aims to communicate better between non-tech to tech over Software trueness and quality.
The readable behavior also serves as documentation.

Gherkin plugin works with Android Studio 2.0. Manual translation is still required but .feature file has pretty syntax highlighting and any invalid cucumber syntax will be flagged with an error.

Install Plugin: Android Studio > Preferences > Plugins > Search "Gherkin" > Install & Restart Android Studio


  1. Add dependencies

    androidTestCompile ''
    androidTestCompile ''  // <-- match with the support lib version
    androidTestCompile 'info.cukes:cucumber-android:[email protected]'
    androidTestCompile 'info.cukes:cucumber-picocontainer:1.2.4'
  2. Create custom instrumentation runner under androidTest package

    public class Instrumentation extends MonitoringInstrumentation {
        private final CucumberInstrumentationCore mInstrumentationCore = new CucumberInstrumentationCore(this);
        public void onCreate(Bundle arguments) {
        public void onStart() {
  3. Application ID / Runner setup in app/build.gradle. Make sure this matches with the package name of the test.

    testApplicationId "com.emmasuzuki.cucumberespressodemo.test"
    testInstrumentationRunner "com.emmasuzuki.cucumberespressodemo.test.Instrumentation"
  4. Create assets/features directory under androidTest. This directory holds behavior(.feature) files.

  5. Set assets directory in app/build.gradle.

    android {
        sourceSets {
            androidTest {
                assets.srcDirs = ['src/androidTest/assets']

Write behavior

Make a file, login.feature, and put under src/androidTest/assets/features.

Feature: Login
Perform login on email and password are inputted

  Scenario Outline: Input email and password in correct format
    Given I have a LoginActivity
    When I input email <email>
    And I input password "<password>"
    And I press submit button
    Then I should <see> auth error

    | email              | password   | see   |
    | [email protected] | bananacake | true  |
    | [email protected] | lemoncake  | false |     <-- valid email and password
    | [email protected]    | lemoncake  | true  |

Write step definition

EX) "Given I have a LoginActivity" in behavior translates to

@Given("^I have a LoginActivity")
public void I_have_a_LoginActivity(){}

in step definition.

"Then I should see error on the " in behavior translates to

@Then("^I should see error on the (\\S+)$")
public void I_should_see_error_on_the_editTextView(final String viewName) {}

Write Espresso test in step definition

@When("^I input email (\\S+)$")
public void I_input_email(final String email) {
@Then("^I should (true|false) auth error$")
public void I_should_see_auth_error(boolean shouldSeeError) {
    if (shouldSeeError) {
    } else {


On command line, run with $./gradlew connectedCheck

On Android Studio, take the following steps:

  1. Run > Edit Configurations
  2. Click "+" on left pane
  3. Select Android Tests
  4. Put any name at Name:
  5. Select "app" for module
  6. Hit Apply
  7. Choose the craeted Run configuration
  8. Click Run

Write code to make the behavior pass

Write code and run test again. Observe the tests pass.

Popular Espresso Projects
Popular Cucumber Projects
Popular Software Quality Categories

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.