Android Espresso UI Testing & UI/Application Exerciser Monkey

An overview on how Espresso works for Android instrumentation testing, also there is an overview of Application Exerciser Monkey, a utility tool from the Android SDK.

Transcript

1. Android Espresso UI Testing & UI/Application Exerciser Monkey Jorge E. Hernández @lalongooo
2. Espresso - Testing framework for Android UI testing - Used by devs familiar with the Android app codebase - Lets you interact with your Android app just like any user would do - Runs on emulators or physical devices
14. textViewMessage editTextMessage buttonChangeText buttonChangeTextActivity
15. // Find the EditText
16. // Find the EditText onView(withId(R.id.editTextMessage))
17. // Find the EditText onView(withId(R.id.editTextMessage)) // ... then type some text
18. // Find the EditText onView(withId(R.id.editTextMessage)) // ... then type some text .perform(typeText(TEXT_TO_BE_TYPED))
19. // Find the EditText onView(withId(R.id.editTextMessage)) // ... then type some text & close the soft keyboard .perform(typeText(TEXT_TO_BE_TYPED))
20. // Find the EditText onView(withId(R.id.editTextMessage)) // ... then type some text & close the soft keyboard .perform(typeText(TEXT_TO_BE_TYPED), closeSoftKeyboard())
21. // Find the EditText onView(withId(R.id.editTextMessage)) // ... then type some text & close the soft keyboard .perform(typeText(TEXT_TO_BE_TYPED), closeSoftKeyboard()) // Find the button
22. // Find the EditText onView(withId(R.id.editTextMessage)) // ... then type some text & close the soft keyboard .perform(typeText(TEXT_TO_BE_TYPED), closeSoftKeyboard()) // Find the button onView(withId(R.id.buttonChangeText))
23. // Find the EditText onView(withId(R.id.editTextMessage)) // ... then type some text & close the soft keyboard .perform(typeText(TEXT_TO_BE_TYPED), closeSoftKeyboard()) // Find the button, then click on it onView(withId(R.id.buttonChangeText))
24. // Find the EditText onView(withId(R.id.editTextMessage)) // ... then type some text & close the soft keyboard .perform(typeText(TEXT_TO_BE_TYPED), closeSoftKeyboard()) // Find the button, then click on it onView(withId(R.id.buttonChangeText)) .perform(click())
25. // Find the EditText onView(withId(R.id.editTextMessage)) // ... then type some text & close the soft keyboard .perform(typeText(TEXT_TO_BE_TYPED), closeSoftKeyboard()) // Find the button, then click on it onView(withId(R.id.buttonChangeText)) .perform(click()) // Find the TextView with the message
26. // Find the EditText onView(withId(R.id.editTextMessage)) // ... then type some text & close the soft keyboard .perform(typeText(TEXT_TO_BE_TYPED), closeSoftKeyboard()) // Find the button, then click on it onView(withId(R.id.buttonChangeText)) .perform(click()) // Find the TextView with the message onView(withId(R.id.textViewMessage))
27. // Find the EditText onView(withId(R.id.editTextMessage)) // ... then type some text & close the soft keyboard .perform(typeText(TEXT_TO_BE_TYPED), closeSoftKeyboard()) // Find the button, then click on it onView(withId(R.id.buttonChangeText)) .perform(click()) // Find the TextView with the message, then check text was changed onView(withId(R.id.textViewMessage))
28. // Find the EditText onView(withId(R.id.editTextMessage)) // ... then type some text & close the soft keyboard .perform(typeText(TEXT_TO_BE_TYPED), closeSoftKeyboard()) // Find the button, then click on it onView(withId(R.id.buttonChangeText)) .perform(click()) // Find the TextView with the message, then check text was changed onView(withId(R.id.textViewMessage)) .check(matches(withText(TEXT_TO_BE_TYPED)))
29. class { } Where should we place this code?
30. class ChangeTextBehaviorTest { } Where should we place this code?
31. @RunWith(AndroidJUnit4::class) class ChangeTextBehaviorTest { } Where should we place this code?
32. @RunWith(AndroidJUnit4::class) @LargeTest class ChangeTextBehaviorTest { } Where should we place this code?
33. @RunWith(AndroidJUnit4::class) @LargeTest class ChangeTextBehaviorTest { @get:Rule var activityScenarioRule = activityScenarioRule<>().apply { } Where should we place this code?
34. @RunWith(AndroidJUnit4::class) @LargeTest class ChangeTextBehaviorTest { @get:Rule var activityScenarioRule = activityScenarioRule<MainActivity>() } Where should we place this code?
35. @RunWith(AndroidJUnit4::class) @LargeTest class ChangeTextBehaviorTest { @get:Rule var activityScenarioRule = activityScenarioRule<MainActivity>() @Test fun testTextIsChangedWhenButtonIsClicked() { } } Where should we place this code?
36. @RunWith(AndroidJUnit4::class) @LargeTest class ChangeTextBehaviorTest { @get:Rule var activityScenarioRule = activityScenarioRule<MainActivity>() @Test fun testTextIsChangedWhenButtonIsClicked() { // ... your test code here } } Where should we place this code?
38. Your app code (Fragment, Activity, etc)
39. Your app code (Fragment, Activity, etc) Your Espresso classes
40. Your app code (Fragment, Activity, etc) Your Espresso classes
41. How to test a RecyclerView?
42. How to test a RecyclerView? // Find the RecyclerView
43. How to test a RecyclerView? // Find the RecyclerView onView(withId(R.id.myRecyclerView))
44. How to test a RecyclerView? // Find the RecyclerView onView(withId(R.id.myRecyclerView)) // ... perform an action indicating the item position
45. How to test a RecyclerView? // Find the RecyclerView onView(withId(R.id.myRecyclerView)) // ... perform an action indicating the item position .perform( )
46. How to test a RecyclerView? // Find the RecyclerView onView(withId(R.id.myRecyclerView)) // ... perform an action indicating the item position .perform( RecyclerViewActions.actionOnItemAtPosition<>() )
47. How to test a RecyclerView? // Find the RecyclerView onView(withId(R.id.myRecyclerView)) // ... perform an action indicating the item position .perform( RecyclerViewActions.actionOnItemAtPosition<RecyclerView.ViewHolder>() )
48. How to test a RecyclerView? // Find the RecyclerView onView(withId(R.id.myRecyclerView)) // ... perform an action indicating the item position .perform( RecyclerViewActions.actionOnItemAtPosition<RecyclerView.ViewHolder>( 30, click() ) )
49. How to test a RecyclerView? // Find the RecyclerView onView(withId(R.id.myRecyclerView)) // ... perform an action indicating the item position .perform( RecyclerViewActions.actionOnItemAtPosition<RecyclerView.ViewHolder>( 30, // the position of the item in the RecyclerView click() ) )
50. What if we don’t know the position?
51. What if we don’t know the position? // Find the RecyclerView onView(withId(R.id.myRecyclerView)) // ... perform an action indicating the item position .perform( RecyclerViewActions.actionOnItem<RecyclerView.ViewHolder>( hasDescendant(withText(containsString("Your order total is"))), click() ) )
52. What if we don’t know the position? // Find the RecyclerView onView(withId(R.id.myRecyclerView)) // ... perform an action indicating the item position .perform( RecyclerViewActions.actionOnItem<RecyclerView.ViewHolder>( hasDescendant(withText(containsString("Your order total is"))), click() ) )
53. scrollTo() Scrolls to the matched View. scrollToHolder() Scrolls to the matched View Holder. scrollToPosition() Scrolls to a specific position. actionOnHolderItem() Performs a View Action on a matched View Holder. actionOnItem() Performs a View Action on a matched View. actionOnItemAtPosition() Performs a ViewAction on a view at a specific position. More RecyclerViewActions
54. scrollTo() Scrolls to the matched View. scrollToHolder() Scrolls to the matched View Holder. scrollToPosition() Scrolls to a specific position. actionOnHolderItem() Performs a View Action on a matched View Holder. actionOnItem() Performs a View Action on a matched View. actionOnItemAtPosition() Performs a ViewAction on a view at a specific position. That’s it for Espresso… 🤓 More RecyclerViewActions
55. UI/Application Exerciser Monkey
56. UI/Application Exerciser Monkey • Program that runs on your emulator or device
57. UI/Application Exerciser Monkey • Program that runs on your emulator or device • Generates pseudo-random streams of events such as clicks, touches, or gestures, as well as a number of system-level events
58. UI/Application Exerciser Monkey • Program that runs on your emulator or device • Generates pseudo-random streams of events such as clicks, touches, or gestures, as well as a number of system-level events • Use it to stress-test applications that you are developing, in a random yet repeatable manner
59. UI/Application Exerciser Monkey Basic usage Example # Will send 500 random events to the entire system adb shell monkey 500 adb shell monkey [options] <event-count>
60. Stress testing your application # Will launch your application adb shell monkey -p com.example.app
61. Stress testing your application # Will launch your application # Then, will send 500 random events adb shell monkey -p com.example.app
62. Stress testing your application # Will launch your application # Then, will send 500 random events adb shell monkey -p com.example.app 500
63. Verbosity levels
64. # Level 0 (the default) provides little information beyond startup notification, test completion, and final results. Verbosity levels
65. # Level 0 (the default) provides little information beyond startup notification, test completion, and final results. # Level 1 provides more details about the test as it runs, such as individual events being sent to your activities. Verbosity levels
66. # Level 0 (the default) provides little information beyond startup notification, test completion, and final results. # Level 1 provides more details about the test as it runs, such as individual events being sent to your activities. # Level 2 provides more detailed setup information such as activities selected or not selected for testing. Verbosity levels
67. Verbosity levels # Level 0 (the default) provides little information beyond startup notification, test completion, and final results. # Level 1 provides more details about the test as it runs, such as individual events being sent to your activities. # Level 2 provides more detailed setup information such as activities selected or not selected for testing. adb shell monkey -p com.example.app -v -v -v 500
68. Verbosity levels # Level 0 (the default) provides little information beyond startup notification, test completion, and final results. # Level 1 provides more details about the test as it runs, such as individual events being sent to your activities. # Level 2 provides more detailed setup information such as activities selected or not selected for testing. adb shell monkey -p com.example.app -v -v -v 500
69. # Pass a seed value, then use it again # it will generate the same sequence of events. adb shell monkey -p com.example.app -s 7 500 How to reproduce?
70. # Pass a seed value, then use it again # it will generate the same sequence of events. adb shell monkey -p com.example.app -s 7 500 How to reproduce?
71. Throttling # Will send an event each second # Events include launching activities from ignored packages $ The --throttle argument is expressed in milliseconds adb shell monkey --throttle 1000 20
72. Throttling # Will send an event each second # Events include launching activities from ignored packages $ The --throttle argument is expressed in milliseconds adb shell monkey --throttle 1000 20
73. Touch events # Will send 20 events # All of them will be down-up events in a single place on the screen # Pretty much like a single tap on the screen adb shell monkey --pct-touch 100 20
74. # Will send 20 events # All of them will be like swipes in a random manner adb shell monkey --pct-motion 100 20 Motion events
75. # Will send 20 events, 10 touch events & 10 motion events adb shell monkey --pct-touch 50 --pct-motion 50 20 Touch & Motion events combined
76. # Trackball events adb shell monkey --pct-trackball 100 500 Additional monkey options
77. # Trackball events adb shell monkey --pct-trackball 100 500 # Basic navigation events adb shell monkey --pct-nav 100 500 Additional monkey options
78. # Trackball events adb shell monkey --pct-trackball 100 500 # Basic navigation events adb shell monkey --pct-nav 100 500 # "Major" navigation events like # center button in a 5-way pad, the back key, or the menu key adb shell monkey --pct-majornav 100 500 Additional monkey options
79. # Trackball events adb shell monkey --pct-trackball 100 500 # Basic navigation events adb shell monkey --pct-nav 100 500 # "Major" navigation events like # center button in a 5-way pad, the back key, or the menu key adb shell monkey --pct-majornav 100 500 # System events # Home, Back, Start Call, End Call, Volume controls adb shell monkey --pct-syskeys 100 500 Additional monkey options
80. # Trackball events adb shell monkey --pct-trackball 100 500 # Basic navigation events adb shell monkey --pct-nav 100 500 # "Major" navigation events like # center button in a 5-way pad, the back key, or the menu key adb shell monkey --pct-majornav 100 500 # System events # Home, Back, Start Call, End Call, Volume controls adb shell monkey --pct-syskeys 100 500 # Will launch your app via startActivity() adb shell monkey --pct-appswitch 100 500 Additional monkey options
81. Questions?