apress / android-espresso-revealed

Source Code for 'Android Espresso Revealed' by Denys Zelenchuk

Apress Source Code

This repository accompanies Android Espresso Revealed by Denys Zelenchuk (Apress, 2019).

Download the files as a zip using the green button, or clone the repository to your machine using Git.

Releases

Release v1.0 corresponds to the code in the published book, without corrections or updates.

Contributions

See the file Contributing.md for more information on how you can contribute to this repository. A sample TO-DO application project forked from the googlesamples android-architecture and modified in a way to show you most of the Espresso use cases.

AndroidX Test branch.

Content:

chapter1

Explains how to identify Android application UI elements, perform actions, assertions and apply matchers to them.

chapter2

Contains more advanced examples of how to implement custom ViewAction, including clicks and swiping actions; ViewMatcher, such as: matching complex views, RecyclerView matchers or Drawable matchers. It will be shown how to use custom actions and matchers, implement custom FailureHandler.

chapter3

Is about migrating tests written in Java to Kotlin. migrating existing Espresso Java tests to Kotlin, provides an example of creating Espresso DSL.

chapter4

Explains how to handle application network requests or long-lasting operations during test execution with the help of IdlingResource interface. Provides an example about ConditionalWatcher as an alternative to IdlingResource.

chapter5

Shows IntentMatchers usage inside the application under test as well as possibility to stub external intents and provide back extras. Contains an example of external intent stubbing that selects an image from the photo gallery.

chapter6

Gives an overview about testing WebViews inside application under test. Implemented WebViews will showcase different UI elements that Espresso-Web API is able to operate on. The Espresso-Web cheat sheet is also the part of this chapter content and is available under TODO.

chapter7

Current chapter unleashes the topic of how to test application accessibility using Espresso for Android. It raises awareness about the importance of Accessibility testing and gives an overview of manual tools that can be used to test application accessibility.

chapter8

Shows one of the most powerful test automation setups for Android, which combines Espresso test framework together with UI Automator testing tool. Contains the examples of how to test notifications or operate on third party apps during Espresso tests execution.

chapter9

Explains different ways of how we can deal with system permission request dialogs.

chapter10

Demonstrates how to set device in test friendly state to reduce test flakiness. Contains test examples generated by Espresso Test Recorder.

chapter11

Shows how to apply Screen Object (the same as Page Object) architecture approach in Android test project which allows to reduce maintenance effort spent on test maintenance.

chapter12

Contains examples of how to apply Testing Robot Pattern which splits the test implementation from the business logic to Espresso UI tests.

chapter13

Gives an example of how to implement supervised pseudo monkey tests using Espresso and UI Automator which can be applicable for applications you have access to the source code to and for the third-party applications.

chapter14

Demonstrates how to migrate the test code from Android Support to AndroidX Test library and how Truth library can be used in UI tests.

chapter15

Contains code samples that were not covered in other chapters and Espresso testing tips which may increase your daily test writing productivity. It includes creating Parametrized tests, aggregating tests into Test Suites, using AndroidStudio Live templates in UI tests, setting SeekBar progress in Espresso UI tests and Espresso Drawable matchers topics.

Espresso-Web cheat sheet:

UI Automator cheat sheet:

android-espresso-revealed's Issues

Sharing Intent in Task Fragment does not work

There is a broken reference on line 185 under onOptionsItemSelected() method.

case R.id.menu_share:
                String email = PreferenceManager
                        .getDefaultSharedPreferences(getContext())
                        .getString("email_text", "");

"email_text" should match android:key="email_edit_text" found in pref_general.xml