Getting Started with AndroidX Test

Testing on Android is slowly becoming more approachable. With AndroidX Test, you can use a single test API to run your instrumentation tests either on your mobile device, or on your computer using Robolectric. This is great, so how do you start? In this talk you’ll learn how to use AndroidX Test and Espresso to get started writing Integration tests for your app.

Transcript

1. @TTGonda victoriagonda.com Getting Started With AndroidX Test Victoria Gonda
2. @TTGonda victoriagonda.com Why Test? • Make changes with confidence • Living documentation • Encourages maintainable, clean code
3. @TTGonda victoriagonda.com https://twitter.com/TTGonda/status/1100931379150360576
4. @TTGonda victoriagonda.com https://twitter.com/TTGonda/status/1101298440552759297
5. @TTGonda victoriagonda.com https://twitter.com/TTGonda/status/1101677434162814976
6. @TTGonda victoriagonda.com https://twitter.com/TTGonda/status/1102010808324767744
7. @TTGonda victoriagonda.com https://twitter.com/saraceni_br/status/1102643475793829888
8. @TTGonda victoriagonda.com Victoria Gonda • Android Engineer at Buffer • Author and Editor at RayWenderlich.com • Chicago native • Hedgehog and cat owner • she/her
9. @TTGonda victoriagonda.com Testing Tools • JUnit4 • JUnit5 • Retrofit-mock • Espresso • Mockito • Robolectric • Spek • KotlinTest • MockK • Kakao • Hiroaki • Barista • Biscotti • AndroidX Test
10. @TTGonda victoriagonda.com AndroidX Test
11. @TTGonda victoriagonda.com AndroidX Test • Includes some of the libraries you already know, plus some new ones • Aims to solve the issue of too many libraries • Can be run both on device or on the JVM
12. @TTGonda victoriagonda.com What’s Inside?
13. @TTGonda victoriagonda.com What’s Inside? • JUnit • Core • Espresso • Truth Assertions
14. @TTGonda victoriagonda.com JUnit Core Espresso Truth
15. @TTGonda victoriagonda.com
16. @TTGonda victoriagonda.com JUnit Core Espresso Truth
17. @TTGonda victoriagonda.com JUnit
18. @TTGonda victoriagonda.com defaultConfig { testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner" } testImplementation ‘junit:junit:4.12' testImplementation 'androidx.test.ext:junit:1.1.0'
19. @TTGonda victoriagonda.com @RunWith(AndroidJUnit4::class) class MainActivityTest
20. @TTGonda victoriagonda.com val context = ApplicationProvider.getApplicationContext<App>() val appName = context.getString(R.string.app_name)
21. @TTGonda victoriagonda.com android { testOptions.unitTests.includeAndroidResources = true } testImplementation 'org.robolectric:robolectric:4.2.1'
22. @TTGonda victoriagonda.com JUnit Core Espresso Truth
23. @TTGonda victoriagonda.com Core
24. @TTGonda victoriagonda.com @Test fun mainActivityLaunches() { ActivityScenario.launch(MainActivity::class.java) }
25. @TTGonda victoriagonda.com val scenario = ActivityScenario .launch(MainActivity::class.java) scenario.moveToState(Lifecycle.State.CREATED) scenario.moveToState(Lifecycle.State.RESUMED) scenario.recreate() scenario.close()
26. @TTGonda victoriagonda.com val scenario = ActivityScenario .launch(MainActivity::class.java) scenario.moveToState(Lifecycle.State.CREATED) scenario.moveToState(Lifecycle.State.RESUMED) scenario.recreate() scenario.close()
27. @TTGonda victoriagonda.com val scenario = ActivityScenario .launch(MainActivity::class.java) scenario.moveToState(Lifecycle.State.CREATED) scenario.moveToState(Lifecycle.State.RESUMED) scenario.recreate() scenario.close()
28. @TTGonda victoriagonda.com val scenario = ActivityScenario .launch(MainActivity::class.java) scenario.moveToState(Lifecycle.State.CREATED) scenario.moveToState(Lifecycle.State.RESUMED) scenario.recreate() scenario.close()
29. @TTGonda victoriagonda.com @get:Rule val activityRule = ActivityScenarioRule(MainActivity::class.java) // in test function val scenario = activityRule.scenario
30. @TTGonda victoriagonda.com @get:Rule val activityRule = ActivityScenarioRule(MainActivity::class.java) // in test function val scenario = activityRule.scenario
31. @TTGonda victoriagonda.com testImplementation 'androidx.fragment:fragment-testing:1.1.0-alpha05'
32. @TTGonda victoriagonda.com val fragmentScenario = FragmentScenario.launch(TaskFragment::class.java) fragmentScenario.moveToState(Lifecycle.State.RESUMED)
33. @TTGonda victoriagonda.com val applicationInfo = ApplicationInfoBuilder .newBuilder() .setPackageName("com.victoriagonda.tasklist") .build() PackageInfoBuilder.newBuilder() .setApplicationInfo(applicationInfo) .build()
34. @TTGonda victoriagonda.com JUnit Core Espresso Truth
35. @TTGonda victoriagonda.com Espresso
36. @TTGonda victoriagonda.com testImplementation 'androidx.test.espresso:espresso-core:3.1.1'
37. @TTGonda victoriagonda.com ViewMatchers.withId ViewActions.click ViewAssertions.matches
38. @TTGonda victoriagonda.com @Test fun mainActivityShowsAddButton() { val scenario = ActivityScenario .launch(MainActivity::class.java) onView(withId(R.id.buttonAddList)) .check(matches(isDisplayed())) }
39. @TTGonda victoriagonda.com @Test fun mainActivityShowsAddButton() { val scenario = ActivityScenario .launch(MainActivity::class.java) onView(withId(R.id.buttonAddList)) .check(matches(isDisplayed())) }
40. @TTGonda victoriagonda.com testImplementation 'androidx.test.espresso:espresso-intents:3.1.1' testImplementation 'androidx.test.espresso:espresso-contrib:3.1.1'
41. @TTGonda victoriagonda.com @Test fun selectingListOpensDetailActivity() { ActivityScenario.launch(MainActivity::class.java) Intents.init() onView(withId(R.id.recyclerView)) .perform(RecyclerViewActions .actionOnItemAtPosition<TaskListViewHolder>(0, click())) Intents.intended(IntentMatchers .hasComponent(DetailActivity::class.java.name)) Intents.release() }
42. @TTGonda victoriagonda.com @Test fun selectingListOpensDetailActivity() { ActivityScenario.launch(MainActivity::class.java) Intents.init() onView(withId(R.id.recyclerView)) .perform(RecyclerViewActions .actionOnItemAtPosition<TaskListViewHolder>(0, click())) Intents.intended(IntentMatchers .hasComponent(DetailActivity::class.java.name)) Intents.release() }
43. @TTGonda victoriagonda.com @Test fun selectingListOpensDetailActivity() { ActivityScenario.launch(MainActivity::class.java) Intents.init() onView(withId(R.id.recyclerView)) .perform(RecyclerViewActions .actionOnItemAtPosition<TaskListViewHolder>(0, click())) Intents.intended(IntentMatchers .hasComponent(DetailActivity::class.java.name)) Intents.release() }
44. @TTGonda victoriagonda.com @Test fun selectingListOpensDetailActivity() { ActivityScenario.launch(MainActivity::class.java) Intents.init() onView(withId(R.id.recyclerView)) .perform(RecyclerViewActions .actionOnItemAtPosition<TaskListViewHolder>(0, click())) Intents.intended(IntentMatchers .hasComponent(DetailActivity::class.java.name)) Intents.release() }
45. @TTGonda victoriagonda.com @Test fun selectingListOpensDetailActivity() { ActivityScenario.launch(MainActivity::class.java) Intents.init() onView(withId(R.id.recyclerView)) .perform(RecyclerViewActions .actionOnItemAtPosition<TaskListViewHolder>(0, click())) Intents.intended(IntentMatchers .hasComponent(DetailActivity::class.java.name)) Intents.release() }
46. @TTGonda victoriagonda.com @Test fun selectingListOpensDetailActivity() { ActivityScenario.launch(MainActivity::class.java) Intents.init() onView(withId(R.id.recyclerView)) .perform(RecyclerViewActions .actionOnItemAtPosition<TaskListViewHolder>(0, click())) Intents.intended(IntentMatchers .hasComponent(DetailActivity::class.java.name)) Intents.release() }
47. @TTGonda victoriagonda.com @Test fun selectingListOpensDetailActivity() { ActivityScenario.launch(MainActivity::class.java) Intents.init() onView(withId(R.id.recyclerView)) .perform(RecyclerViewActions .actionOnItemAtPosition<TaskListViewHolder>(0, click())) Intents.intended(IntentMatchers .hasComponent(DetailActivity::class.java.name)) Intents.release() }
48. @TTGonda victoriagonda.com JUnit Core Espresso Truth
49. @TTGonda victoriagonda.com Truth
50. @TTGonda victoriagonda.com testImplementation 'androidx.test.ext:truth:1.1.0'
51. @TTGonda victoriagonda.com @Test fun selectingListOpensDetailActivity() { ActivityScenario.launch(MainActivity::class.java) Intents.init() onView(withId(R.id.recyclerView)) .perform(RecyclerViewActions .actionOnItemAtPosition(0, click())) val intent = getIntents().first() IntentSubject.assertThat(intent) .hasComponentClass(DetailActivity::class.java) Intents.release() }
52. @TTGonda victoriagonda.com @Test fun selectingListOpensDetailActivity() { ActivityScenario.launch(MainActivity::class.java) Intents.init() onView(withId(R.id.recyclerView)) .perform(RecyclerViewActions .actionOnItemAtPosition(0, click())) val intent = getIntents().first() IntentSubject.assertThat(intent) .hasComponentClass(DetailActivity::class.java) Intents.release() }
53. @TTGonda victoriagonda.com val intent = DetailActivity.newIntent(tasklist, ApplicationProvider.getApplicationContext()) val bundleSubject: BundleSubject = assertThat(intent).extras() bundleSubject.containsKey("EXTRA_TASKLIST") val integerSubject: IntegerSubject = bundleSubject.integer("EXTRA_TASKLIST") integerSubject.isEqualTo(tasklist.id)
54. @TTGonda victoriagonda.com fun newIntent(list: Tasklist, context: Context): Intent { return Intent(context, DetailActivity::class.java) .apply { putExtra("EXTRA_TASKLIST", list.id) } }
55. @TTGonda victoriagonda.com val intent = DetailActivity.newIntent(tasklist, ApplicationProvider.getApplicationContext()) val bundleSubject: BundleSubject = assertThat(intent).extras() bundleSubject.containsKey("EXTRA_TASKLIST") val integerSubject: IntegerSubject = bundleSubject.integer("EXTRA_TASKLIST") integerSubject.isEqualTo(tasklist.id)
56. @TTGonda victoriagonda.com val intent = DetailActivity.newIntent(tasklist, ApplicationProvider.getApplicationContext()) val bundleSubject: BundleSubject = assertThat(intent).extras() bundleSubject.containsKey("EXTRA_TASKLIST") val integerSubject: IntegerSubject = bundleSubject.integer("EXTRA_TASKLIST") integerSubject.isEqualTo(tasklist.id)
57. @TTGonda victoriagonda.com val intent = DetailActivity.newIntent(tasklist, ApplicationProvider.getApplicationContext()) val bundleSubject: BundleSubject = assertThat(intent).extras() bundleSubject.containsKey("EXTRA_TASKLIST") val integerSubject: IntegerSubject = bundleSubject.integer("EXTRA_TASKLIST") integerSubject.isEqualTo(tasklist.id)
58. @TTGonda victoriagonda.com value of : intent.getComponent().getClassName() expected : com.victoriagonda.android.tasklist.DetailActivity but was : com.victoriagonda.android.tasklist.MainActivity
59. @TTGonda victoriagonda.com Wanted to match 1 intents. Actually matched 0 intents. IntentMatcher: has component: has component with: class name: is "com.victoriagonda.android.tasklist.DetailActivity" package name: an instance of java.lang.String short class name: an instance of java.lang.String Matched intents:[] Recorded intents: -Intent { cmp=com.victoriagonda.android.tasklist/.MainActivity (has extras) } handling packages:[[com.victoriagonda.android.tasklist]], extras:[Bundle[{EXTRA_TASKLIST=1}]])
60. @TTGonda victoriagonda.com value of : intent.getExtras() expected to contain key EXTRA_TASKLIST but was : Bundle[{EXTRA_TASKNAME=Laundry}]
61. @TTGonda victoriagonda.com value of : intent.getExtras().getInt(EXTRA_TASKLIST) expected : 4 but was : 5
62. @TTGonda victoriagonda.com junit.framework.AssertionFailedError: Expected :4 Actual :5
63. @TTGonda victoriagonda.com • MotionEvent • PointerCoords • PointerProperties • IntentCorrespondences • IntentCorrespondences • NotificationAction • Notification • PendingIntent
64. @TTGonda victoriagonda.com Wrapping Up • Google wrapped up all testing under one AndroidX roof • Four parts, JUnit, Core, Espresso, Truth • Can ALL be run on or off device • Hopefully means less APIs to learn and less worry about on or off device
65. @TTGonda victoriagonda.com Project Nitrogin?
66. @TTGonda victoriagonda.com Thanks! https://vgonda.github.io/Talk-Resources/