AyyalAwwad / Espresso-Examples

Helpful Espresso snippets for Android UI testing.

Espresso-Examples

A reference project for all of those things you forgot how to do in Espresso!

About

This repository contains an example Android application and a number of helpful Espresso UI tests to act as a helpful reference. The Espresso Package Reference can be found here.

How to use

To use test execute the tests you will can execute using the gradle command: ./gradlew app:createDebugCoverageReport or by building the tests with a test configuration in Android Studio.

Libraries used

• Android Testing Library

      dependencies {
          androidTestCompile 'com.android.support.test:testing-support-lib:0.1'
      }

• Espresso 2.0 Core

      dependencies {
          androidTestCompile 'com.android.support.test.espresso:espresso-core:2.0'
      }

• Espresso 2.0 Contrib

      dependencies {
          androidTestCompile 'com.android.support.test.espresso:espresso-contrib:2.0'
      }

• Jacocco Code Coverage

      debug {
          testCoverageEnabled true
      }

Espresso library usage and where to find them

Below is an example of theEspresso methods that have been used so far in the example application.

Matchers

The onView(Matcher<View>) method can accept Matchers to identify a View.

• withText(String)

  • MainActivityTests
  • SwitchActivityTests
  • NavigationDrawerTests
  • ViewPagerTests

• withId(int)

  • MainActivityTests
  • SwitchActivityTests
  • ViewPagerTests

• isDisplayed()

  • MainActivityTests
  • NavigationDrawerTests
  • ViewPagerTests

• isEnabled()

  • MainActivityTests

• isTouchable()

  • MainActivityTests

• isChecked()

  • MainActivityTests

• isNotChecked()

  • MainActivityTests

• isAssignableFrom(Matcher)

  • MainActivityTests

• withHint(int|String)

  • PositionActivityTests

• withParent(Matcher<T>)

  • HierarchyActivityTests

• isDescendentOfA(Matcher<T>)

  • HierarchyActivityTests

• withChild(Matcher<T>)

  • HierarchyActivityTests

• hasSibling(Matcher<T>)

  • HierarchyActivityTests

• hasDescendant(Matcher<T>)

  • HierarchyActivityTests

Hamcrest Matchers

• allOf(Matcher<T> ...)

  • MainActivityTests
  • NavigationDrawerTests

• not(Object)

  • SwitchActivityTests

• endsWith(String)

  • MainActivityTests

• startsWith(String)

  • MainActivityTests

Actions

Actions are performed using the perform(ViewAction) method.

• click()

  • MainActivityTests
  • NavigationDrawerTests
  • SwitchActivityTests

• pressBack()

  • NavigationDrawerTests

• typeText(String)

  • MainActivityTests

• clearText()

  • MainActivityTests

• replaceText(String)

  • MainActivityTests

• swipeLeft()

  • ViewPagerTests

• swipeRight()

  • ViewPagerTests

• swipeUp()

  • MainActivityTests

• swipeDown()

  • MainActivityTests

• closeSoftKeyboard()

  • MainActivityTests

• hasContentDescription()

  • MainActivityTests

• withContentDescription(String)

  • MainActivityTests

• scrollTo()

  • MainActivityTests

Assertions

Assertions are performed using the check(ViewAssertion) method.

• matches(Matcher<T>)

  • NavigationDrawerTests
  • SwitchActivityTests
  • MainActivityTests

• isLeftOf(Matcher)

  • PositionActivityTests

• isRightOf(Matcher)

  • PositionActivityTests

• isAbove(Matcher)

  • PositionActivityTests

• isBelow(Matcher)

  • PositionActivityTests

• isLeftAlignedWith(Matcher)

  • PositionActivityTests

• isRightAlignedWith(Matcher)

  • PositionActivityTests

• isTopAlignedWith(Matcher)

  • PositionActivityTests

• isRightAlignedWith(Matcher)

  • PositionActivityTests

• doesNotExist()

  • PositionActivityTests

• selectedDescendantsMatch(Matcher)

  • HierarchyActivityTests

• noEllipsizedText(Matcher)

  • HierarchyActivityTests

• selectedDescendantsMatch(Matcher)

  • HierarchyActivityTests

• noOverlaps(Matcher)

  • HierarchyActivityTests

Widgets

Below is a short list of the Widgets and Views that are tested in this Repository.

Tested

• TextView

• Button

• EditText

• Overflow Menu

• App Drawer

• ViewPager

To be tested

• Spinner

• ProgressBar

• ViewPager

• PagerTabStrip

• Date and Time Widgets

To be demonstrated

• Idling Resources

JaCoCo Coverage

The JaCoCo Coverage plugin has been included to demonstrate coverage reporting. The Code Coverage can be found in the following directory structure within the module you are testing build/outputs/reports/coverage/debug/index.html

Contact me

+JordanTerry

@Jordan_Terry