Super Heroes Kata for Android Developers in Kotlin. The main goal is to practice UI Testing.
This repository contains an Android application to show Super Heroes information:
This Application is based on two Activities:
MainActivity
showing a list of super heroes with name, photo and a special badge if is part of the Avengers Team.SuperHeroDetailActivity
showing 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 find Kodein
configured to be able to replace production code with test doubles easily and Espresso to be able to interact with the application user interface.
Your task as Android Developer is to write all the UI tests needed 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
kata-super-heroes
branch.MainActivityTest
and watch the only test it contains pass.To help you get started, these are some test cases for MainActivity
:
SuperHeroRepository
in MainActivityTest
to return a list of some Super Heroes.SuperHeroesRepository
returns a list of some Super Heroes.If you get stuck, master
branch contains already solved tests for MainActivity
and SuperHeroDetailActivity
You will find some utilities to help you test RecyclerViews and Toolbars easily in:
app/src/androidTest/java/com/karumi/matchers
and app/src/androidTest/java/com/karumi/recyclerview
.
RecyclerViewInteraction
: provides an easy way to apply an Espresso matcher to all of the RecyclerView elements
RecyclerViewInteraction.onRecyclerView<ITEM_TYPE>(withId(R.id.recycler_view))
.withItems(A_LIST_OF_ITEMS)
.check({ item, view, e -> matches(A_MATCHER).check(view, e) })
RecyclerViewItemsCountMatcher
: a matcher that returns true if RecyclerView contains the expected number of elements.
ToolbarMatcher
: a matcher that returns true if a Toolbar with expected title is found.
If you've covered all the application functionality using UI tests try to continue with the following tasks:
MainActivity
and test it.SuperHeroDetailActivity
to 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.SnackBar
to indicate something went wrong.SuperHeroesRepository
test double to perform a Thread.sleep
and use the custom idling resources you'll find in this repository to get your tests working.There are some links which can be useful to finish these tasks:
Data provided by Marvel. © 2017 MARVEL
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.