Android UI Testing

Barista is an awesome library that helps you write simple to understand and easy to read UI tests. The library also contains helpful Rules you can use to setup your tests properly which will increase the stability of your tests. This is an intro to the Barista library and what it offers

Transcript

1. PETER TÖRNHULT @petertornhult medium.com/@peter.tornhult
2. Android UI Testing
3. Espresso Test Recorder Run -> Record Espresso Test
5. @LargeTest @RunWith(AndroidJUnit4::class) class MainActivityTest { @Rule @JvmField var mActivityTestRule = ActivityTestRule(MainActivity::class.java) @Rule @JvmField var mGrantPermissionRule = GrantPermissionRule.grant( "android.permission.ACCESS_FINE_LOCATION", "android.permission.ACCESS_COARSE_LOCATION") @Test fun mainActivityTest() { val appCompatButton = onView( allOf(withId(android.R.id.button1), withText("Accept"), childAtPosition( childAtPosition( withId(R.id.buttonPanel), 0), 3))) appCompatButton.perform(scrollTo(), click()) val bottomNavigationItemView = onView( allOf(withId(R.id.action_games), withContentDescription("Games"), childAtPosition( childAtPosition( withId(R.id.tabs), 0), 1), isDisplayed())) bottomNavigationItemView.perform(click()) val floatingActionButton = onView( allOf(withId(R.id.createNewGameButton),
6. @LargeTest @RunWith(AndroidJUnit4::class) class MainActivityTest { @Rule @JvmField var mActivityTestRule = ActivityTestRule(MainActivity::class.java) @Rule @JvmField var mGrantPermissionRule = GrantPermissionRule.grant( "android.permission.ACCESS_FINE_LOCATION", "android.permission.ACCESS_COARSE_LOCATION") @Test fun mainActivityTest() { val appCompatButton = onView( allOf(withId(android.R.id.button1), withText("Accept"), childAtPosition( childAtPosition( withId(R.id.buttonPanel), 0), 3))) appCompatButton.perform(scrollTo(), click()) val bottomNavigationItemView = onView( allOf(withId(R.id.action_games), withContentDescription("Games"), childAtPosition( childAtPosition( withId(R.id.tabs), 0), 1), isDisplayed())) bottomNavigationItemView.perform(click()) val floatingActionButton = onView( allOf(withId(R.id.createNewGameButton), childAtPosition( allOf(withId(R.id.games_container), childAtPosition( withClassName(`is`("android.widget.FrameLayout")), 0)), 2), isDisplayed())) floatingActionButton.perform(click()) val materialCardView = onView( allOf(childAtPosition( allOf(withId(R.id.list), childAtPosition( withId(R.id.swipeRefreshListLayout), 0)), 2), isDisplayed())) materialCardView.perform(click()) val materialCardView2 = onView( allOf(childAtPosition( allOf(withId(R.id.list), childAtPosition( withId(R.id.swipeRefreshListLayout), 0)), 2), isDisplayed())) materialCardView2.perform(click()) val materialCardView3 = onView( allOf(childAtPosition( allOf(withId(R.id.list), childAtPosition( withId(R.id.swipeRefreshListLayout), 0)), 4), isDisplayed())) materialCardView3.perform(click()) val appCompatButton2 = onView( allOf(withId(R.id.gameType), withText("Stroke Play"), childAtPosition( allOf(withId(R.id.bottomMenu), childAtPosition( withClassName(`is`("androidx.coordinatorlayout.widget.CoordinatorLayout")), 2)), 0), isDisplayed())) appCompatButton2.perform(click()) val appCompatRadioButton = onView( allOf(withId(R.id.matchPlay), withText("Match play\nTwo players"), childAtPosition( childAtPosition( withClassName(`is`("android.widget.ScrollView")), 0), 2))) appCompatRadioButton.perform(scrollTo(), click()) } private fun childAtPosition( parentMatcher: Matcher<View>, position: Int): Matcher<View> { return object : TypeSafeMatcher<View>() { override fun describeTo(description: Description) { description.appendText("Child at position $position in parent ") parentMatcher.describeTo(description) } public override fun matchesSafely(view: View): Boolean { val parent = view.parent return parent is ViewGroup && parentMatcher.matches(parent) && view == parent.getChildAt(position) } } } }
7. @LargeTest @RunWith(AndroidJUnit4::class) class MainActivityTest { ... }
8. @LargeTest @RunWith(AndroidJUnit4::class) class MainActivityTest { @Rule @JvmField var mActivityTestRule = ActivityTestRule(MainActivity::class.java) ... }
9. @LargeTest @RunWith(AndroidJUnit4::class) class MainActivityTest { @Rule @JvmField var mActivityTestRule = ActivityTestRule(MainActivity::class.java) @Rule @JvmField var mGrantPermissionRule = GrantPermissionRule.grant( "android.permission.ACCESS_FINE_LOCATION", "android.permission.ACCESS_COARSE_LOCATION") ... }
10. @LargeTest @RunWith(AndroidJUnit4::class) class MainActivityTest { @Test fun mainActivityTest() { ... } }
11. val appCompatButton = onView( allOf(withId(android.R.id.button1), withText("Accept"), childAtPosition( childAtPosition( withId(R.id.buttonPanel), 0), 3))) appCompatButton.perform(scrollTo(), click())
12. private fun childAtPosition( parentMatcher: Matcher<View>, position: Int): Matcher<View> { return object : TypeSafeMatcher<View>() { override fun describeTo(description: Description) { description.appendText("Child at position $position in parent ") parentMatcher.describeTo(description) } public override fun matchesSafely(view: View): Boolean { val parent = view.parent return parent is ViewGroup && parentMatcher.matches(parent) && view == parent.getChildAt(position) } } }
13. Espresso UI Tests Shift + Ctrl + T Win Shift + ⌘ + T Mac
14. Espresso: Test Class @LargeTest @RunWith(AndroidJUnit4::class) class MainActivityTest { }
15. Espresso: Activity Rule @LargeTest @RunWith(AndroidJUnit4::class) class MainActivityTest { @Rule @JvmField var mActivityTestRule = ActivityTestRule(MainActivity::class.java) }
16. Espresso: Test(s) @LargeTest @RunWith(AndroidJUnit4::class) class MainActivityTest { @Rule @JvmField var mActivityTestRule = ActivityTestRule(MainActivity::class.java) @Test fun app_should_launch() { ... } @Test fun feature1_should_be_shown() { ... } }
17. Espresso: Grant Permission Rule @LargeTest @RunWith(AndroidJUnit4::class) class MainActivityTest { @Rule @JvmField var mActivityTestRule = ActivityTestRule(MainActivity::class.java) @Rule @JvmField var mGrantPermissionRule = GrantPermissionRule.grant( "android.permission.ACCESS_FINE_LOCATION", "android.permission.ACCESS_COARSE_LOCATION") … }
18. Espresso: Testing @Test fun mainActivityTest() { onView(withText("Accept")) .perform(scrollTo(), click()) onView(withId(R.id.nav_games)) .perform(click()) … }
19. Espresso: Testing @Test fun mainActivityTest() { onView(withText("Accept")) .check(matches(isDisplayed())) .perform(scrollTo(), click()) onView(withId(R.id.nav_games)) .check(matches(isDisplayed())) .perform(click()) … }
20. Espresso: Import members @Test fun mainActivityTest() { Espresso.onView(ViewMatchers.withText("Accept")) .check(ViewAssertions.matches(ViewMatchers.isDisplayed())) .perform(ViewActions.scrollTo(), ViewActions.click()) Espresso.onView(ViewMatchers.withId(R.id.nav_games)) .check(ViewAssertions.matches(ViewMatchers.isDisplayed())) .perform(ViewActions.click()) … }
21. Espresso: Duplicate ViewMatch + ViewCheck ?!? @Test fun mainActivityTest() { onView(allOf(withText("Accept"), isDisplayed())) .check(matches(isDisplayed())) .perform(scrollTo(), click()) onView(allOf(withId(R.id.nav_games), isDisplayed())) .check(matches(isDisplayed())) .perform(click()) … }
23. Barista https://github.com/AdevintaSpain/Barista
24. Barista Scrolls when needed
25. Barista Scrolls when needed Scrolls on all views
26. Barista Scrolls when needed Scrolls on all views Just interacts with displayed Views
27. Barista: Simplified Syntax clickOn(R.id.action_home) clickOn(R.string.home_title) clickOn("Home") clickBack()
28. Barista: Interact syntax clickOn(R.id.button) clickOn(R.string.button) clickOn("Button") clickBack() longClickOn(R.id.button) clickMenu(R.id.menu)
29. Barista: Interact syntax writeTo(R.id.editText, "Text") writeToAutoComplete(R.id.editText, "Text") clearText(R.id.editText)
30. Barista ListViews, RecyclerViews RadioButtons Time/Date Pickers Dialogs Scroll / Pagers NavDrawers SeekBars SwipeRefreshLayout Keyboard
31. Barista: Assertions assertDisplayed("Ok") assertDisplayed(R.string.ok) assertDisplayed(R.id.ok_button) assertDisplayed(R.id.ok_button, R.string.ok) assertEnabled(...) / assertDisabled(...) assertNotExist(...) assertChecked(...) / assertUnchecked(...) assertClickable(...) / assertNotClickable(...) assertFocused(...) / assertNotFocused(...) etc...
32. Barista: Runtime permissions PermissionGranter .allowPermissionsIfNeeded(Manifest.permission. GET_ACCOUNTS)
33. Barista: Rulez ClearPreferencesRule ClearDatabaseRule ClearFilesRule
34. Barista: Real world @Test fun verifyHomeScreen() { DbHelper.setupSomePlayedGames(appDatabase) activityTestRule.launchActivity(null) assertDisplayed(R.id.closestCourseCard) assertDisplayed(R.id.onboardingView) clickOn(R.id.viewResults) verifyGameResultsScreen() clickBack() clickOn(R.id.resumeGame) verifyOngoingGameScorecardScreen() clickBack() onView(withId(R.id.home_container)) .perform(swipeUp()) assertDisplayed(R.id.rateAppView) assertDisplayed(R.id.restartOnCourse)
35. Barista https://github.com/AdevintaSpain/Barista
36. Espresso Test Recorder Easy to get started with No coding required Helpful finding view matchers Hard to read generated code Selects obscure elements Almost impossible to update when app changes Easy to become neglected
37. Espresso UI Tests Pretty easy to get started with Well documented Relatively easy to maintain Can test *anything in your app Lots of boilerplate code scrollTo Second class code syndrome Hard to fix if left neglected @Ignore is your worst enemy!
38. Barista Super simple to work with Well documented Write tests you will understand Opensource + 1K Stars / Maintained Some conflicting names with Espresso Not supported by big Company
39. Read the docs! ;) Window animation scale Transition animation scale Animator duration scale
40. Links https://github.com/AdevintaSpain/Barista https://www.youtube.com/watch?v=JRkDVvB106k https://www.youtube.com/watch?v=kL3MCQV2M2s https://developer.android.com/training/testing/espresso https://developer.android.com/training/testing/espresso/cheat-sheet
41. THANK YOU PETER TÖRNHULT @petertornhult medium.com/@peter.tornhult