KataScreenshot in Kotlin

• We are here to practice UI testing usingscreenshot tests for Android.
• We are going to useEspressoto interact with the Application UI.
• We are going to useKodeinto replace production code withTest Doubles.
• We are going to practice pair programming.

You can compare this testing approach witha different testing strategywhere the application UI is tested using just Espresso.

---

Getting started

This repository contains an Android application to show Super Heroes information:

This Application is based on two Activities:

• MainActivityshowing a list of super heroes with name, photo and a special badge if it is part of the Avengers Team.

• SuperHeroDetailActivityshowing detailed information about a super hero like his or her name, photo and description.

The application architecture, dependencies and configuration is ready to just start writing tests. In this project you'll findKodeinconfigured to be able to replace production code with test doubles easily and Espresso to be able to interact with the application user interface and a screenshot testing framework ready to compare your application changes.

Remember that after any production code change you can record your screenshots again executing:

./gradlew executeScreenshotTests -Precord

To verify the correct behaviour of your code you can execute:

./gradlew executeScreenshotTests

To be able to get a deterministic test scenario all our tests will be executed on the same emulated device. You can use the Travis-CI configuration to get the same emulator working on your computer.

Tasks

Your task as Android Developer is towrite all the UI testsneeded to check if the Application UI is working as expected.

This repository is ready to build the application, pass the checkstyle and your tests in Travis-CI environments.

Our recommendation for this exercise is:

• Before starting

  1. Fork this repository.
  2. Checkoutkata-screenshotbranch.
  3. Execute the application, explore it manually and make yourself familiar with the code.
  4. ExecuteMainActivityTestand watch the only test it contains pass.

• To help you get started, these are some test cases forMainActivity:

  1. Setup mockedSuperHeroRepositoryinMainActivityTestto return a list of some Super Heroes.
  2. Test theMainActivityis showing the super heroes obtained from theSuperHeroesRepository.
  3. Test the empty case is shown if there are no super heroes.

Considerations

• If you get stuck,masterbranch contains already solved tests forMainActivity,SuperHeroDetailActivityandSuperHeroViewHolder.

Extra Tasks

If you've covered all the application functionality using UI tests try to continue with the following tasks:

• Add a pull to refresh mechanism toMainActivityand test it.
• ModifySuperHeroDetailActivityto handle an error case where the name of the super hero used to start this activity does not exist and show a message if this happens.
• Modify the project to handle connection errors and show aSnackBarto indicate something went wrong.
• ModifySuperHeroesRepositorytest double to perform aThread.sleepand use the custom idling resources you'll find in this repository to get your tests working.
• Compare your tests implementation with theKataSuperHeroessolved using Espresso.

---

Documentation

There are some links which can be useful to finish these tasks:

• Screenshot Kata in Java
• Screenshot Testing Framework
• Android Testing Support Library official documentation
• Espresso Cheat Sheet
• Espresso Idling Resources

Data provided by Marvel. © 2017 MARVEL

License

Copyright 2017 Karumi

Licensed under the Apache License, Version 2.0 (the "License" ); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.