share

ENGINEERING

4min read

Android Espresso - 4 tools you should be using

Introduction

If you ever tried automating user interface tests for Android applications, you know it can be challenging. But we should remember that writing good and effective tests should be fun at the same time! Knowing the right tools can save you a lot of time and effort so I have prepared the list of my favorites.

Android Espresso is my first choice when it comes to testing framework. It is easy to set up, fast, reliable and has a fluent API. On the other hand, it is not perfect yet. Espresso does not provide some obvious solutions even with typical operations that happen during writing automation tests, such as:

  • Setting up application into a testable state
  • Setting application locale
  • Granting runtime permissions for the application
  • Turning on/off the network or Wi-Fi data
  • Turning off device’s animations
  • Mocking and simulating different API states
  • Parallel tests execution on multiple devices
  • Generating readable and meaningful test reports

Have your ever experienced that? Fortunately, by using few additional libraries and shortcuts, this can all become much simpler. Let’s take a look at some easy-to-get solutions you may use.

Test Butler

Test Butler tool provides a couple of features that will make your Android testing more reliable and flexible. Test Butler is a two-part project. It includes an Android library that your test code can depend on, as well as a companion Android apk file that must be installed on Android emulator before test suite execution.

We use Test Butler especially to:

  • Grant runtime permissions
String accessCoarseLocation = Manifest.permission.ACCESS_COARSE_LOCATION;
String accessFineLocation = Manifest.permission.ACCESS_FINE_LOCATION;

TestButler.grantPermission(context, accessCoarseLocation);
TestButler.grantPermission(context, accessFineLocation);
  • Simulate running the app in specific language
TestButler.setLocale("pl", "PL", context);
  • Turn on/off network or Wi-Fi data
TestButler.setGsmState(false);
TestButler.setWifiState(false);

Simple, right? Just a single line of code is enough to perform each setup. But - it comes with a price - Test Butler works only on Android simulators.

RESTMock

RESTMock library lets us to mock API HTTP responses in Android Espresso tests. It can be really helpful when it comes to writing reliable and maintainable automation tests. RESTMock helps to:

  • Speed up test execution by skipping communication between API and application under the test
RESTMockServer
          .whenPOST(pathContains("/auth"))
          .thenReturnFile("login_response.json");
  • Simulate different API conditions such as HTTP 5xx error or incorrect responses
RESTMockServer
          .whenGET(pathContains("/userdata"))
          .thenReturnFile(500, "userdata_response.json");
  • Simulate API responses delays. It is especially handy in testing how application under the test behaves on API timeouts or in bad network conditions
 RESTMockServer
           .whenGET(pathContains("/userdata"))
           .thenReturnFile("userdata_response.json")
           .delay(TimeUnit.SECONDS, 15);

Easy preferences

A lot of Android applications use Shared Preferences to store application data, settings or cache. Easy Preference library lets us to simplify the interaction with Shared Preferences on Android and helps us to avoid writing boilerplate code. One of the application, to which I wrote the tests, had a user field form, where user data has been cached. Setting up already prefilled form in @Before method lets Android Espresso save a lot of time before each test’s execution:

@Before
public void setUserData()
{
        EasyPreference.with(context)
               .addString("firstName", "John")
               .addString("lastName", "Doe")
               .addString("city", "Warsaw")
               .save();
    }

We should not forget to clean up test environment after each test:

@After
public void clearSharedPreferences() {
        EasyPreference.with(context)
                .clearAll()
                .save();
    }

Spoon

We have already set up all great libraries and written tests. Now it’s time to execute them and take a look at the test report. Thanks to the Spoon tool we are able to run Android Espresso tests on multiple devices simultaneously. Spoon will run on all targets which are visible to adb devices.

Once all tests are completed, a static HTML summary is generated with detailed information about each device and test.

spoon.png

In addition to simply running Espresso tests, Spoon has the ability to snap screenshots at key points during your tests which are then included in the output. This allows for visual inspection of test executions across different devices.

Taking screenshots requires including the spoon-client JAR in your instrumentation app. In your tests, call the screenshot method with a human-readable tag.

Spoon.screenshot(activity, "after_login");

Conclusion

Automating user interface testing on Android applications is not a piece of cake. That’s why, you should always look for solutions that make your testing easier and faster. The presented set of tools can certainly save you a lot of time and make your Android Espresso tests more efficient.

share


TomekLead Test Engineer

LEARN MORE

Contact us if you have any questions regarding the article or just want to chat about technology, our services, job offers and more!

POLIDEA NEWSLETTER

Sign in and expect sharp insights, recommendations, ebooks and fascinating project stories delivered to your inbox

The controller of the personal data that you are about to provide in the above form will be Polidea sp. z o.o. with its registered office in Warsaw at ul. Przeskok 2, 00-032 Warsaw, KRS number: 0000330954, tel.: 0048 795 536 436, email: hello@polidea.com (“Polidea”). We will process your personal data based on our legitimate interest and/or your consent. Providing your personal data is not obligatory, but necessary for Polidea to respond to you in relation to your question and/or request. If you gave us consent to call you on the telephone, you may revoke the consent at any time by contacting Polidea via telephone or email. You can find detailed information about the processing of your personal data in relation to the above contact form, including your rights relating to the processing, HERE.

Data controller:

The controller of your personal data is Polidea sp. z o.o. with its registered office in Warsaw at ul. Przeskok 2, 00-032 Warsaw, KRS number: 0000330954, tel.: [0048795536436], email: [hello@polidea.com] (“Polidea”)

Purpose and legal bases for processing:

 

Used abbreviations:

GDPR – Regulation (EU) 2016/679 of the European Parliament and of the Council of 27 April 2016
on the protection of natural persons with regard to the processing of personal data and on the free movement
of such data, and repealing Directive 95/46/EC (General Data Protection Regulation)

ARES – Polish Act on Rendering Electronic Services dated 18 July 2002

TL – Polish Telecommunications Law dated 16 July 2004

1)        sending to the given email address a newsletter including information on Polidea’s new projects, products, services, organised events and/or general insights from the mobile app business world |art. 6.1 a) GDPR, art. 10.2 ARES and art. 172.1 TL (upon your consent)

Personal data:name, email address

2)       statistical, analytical and reporting purposes |art. 6. 1 f) GDPR (based on legitimate interests pursued by Polidea, consisting in analysing the way our services are used and adjusting them to our clients’ needs, as well as developing new services)

Personal data:name, email address

Withdrawal of consent:

You may withdraw your consent to process your personal data at any time.

Withdrawal of the consent is possible solely in the scope of processing performed based on the consent. Polidea is authorised to process your personal data after you withdraw your consent if it has another legal basis for the processing, for the purposes covered by that legal basis.

Categories of recipients:

Your personal data may be shared with:

1)       authorised employees and/or contractors of Polidea

2)       persons or entities providing particular services to Polidea (accounting, legal, IT, marketing and advertising services) – in the scope required for those persons or entities to provide those services to Polidea

 

Retention period:

1)       For the purpose of sending newsletter to the given email address – for as long as the relevant consent is not withdrawn

2)       For statistical, analytical and reporting purposes – for as long as the relevant consent is not withdrawn

Your rights:

 

Used abbreviation:

GDPR – Regulation (EU) 2016/679 of the European Parliament and of the Council of 27 April 2016
on the protection of natural persons with regard to the processing of personal data and on the free movement
of such data, and repealing Directive 95/46/EC (General Data Protection Regulation)

According to GDPR, you have the following rights relating to the processing of your personal data, exercised by contacting Polidea via [e-mail, phone].

1)       to access to your personal data (art. 15 GDPR) by requesting sharing and/or sending a copy of all your personal data processed by Polidea

2)       to request rectification of inaccurate personal data
(art. 16 GDPR) by indicating the data requiring rectification

3)       to request erasure of your persona data (art. 17 GDPR); Polidea has the rights to refuse erasing the personal data in specific circumstances provided by law

4)       to request restriction of processing of your personal data (art. 18 GDPR) by indicating the data which should be restricted

5)       to move your personal data (art. 20 GDPR) by requesting preparation and transfer by Polidea of the personal data that you provided to Polidea to you or another controller in a structured, commonly used machine-readable format

6)       to object to processing your personal data conducted based on art. 6.1 e) or f) GDPR, on grounds relating to your particular situation (art. 21 GDPR)

7)       to lodge a complaint with a supervisory authority,
in particular in the EU member state of your habitual residence, place of work or place of the alleged infringement if you consider that the processing
of personal data relating to you infringes the GDPR
(art. 77.1 GDPR)

No obligation to provide data:

Providing your personal data is not obligatory, but necessary for Polidea to provide you the newsletter service

Refusal to provide the above data will result in inability to receive the newsletter service.

Profiling

In the process of providing the newsletter service, we make decisions in an automated way, including profiling, based on the data you provide.

 

“Profiling” means automated processing of personal data consisting of the use of your personal data to evaluate certain personal aspects relating to you, in particular to analyze or predict aspects concerning your personal preferences and interests.

 

The automated decisions are taken based on the analysis of clicked and viewed content. They affect the targeting of specific newsletter content to selected users registered to receive the newsletter service, based on the anticipated interests of the recipient.