ui automator added to espresso

Author: maciej-nowak

_drafts/2019-02-04-espresso.md

@@ -6,8 +6,8 @@ categories: ["Testowanie"]
 image: testing/espresso
 github: testing/tree/master/espresso
 description: "Testowanie"
-version: Espresso v3.1
-keywords: "testowanie, testing, testy, jednostkowe, integracyjne, manualne, ui, automatyczne, instrumentalne, zaślepka, atrapa, unit test, mock, stub, espresso, android, programowanie, programming"
+version: Espresso v3.1, UI Automator v2.2
+keywords: "testowanie, testing, testy, jednostkowe, integracyjne, manualne, ui, automatyczne, instrumentalne, unit test, espresso, uiautomator, android, programowanie, programming"
 ---
 
 ## Testy UI
@@ -46,6 +46,14 @@ class MainActivity : AppCompatActivity() {
             startActivity(intent)
         }
 
+        buttonSms.setOnClickListener {
+            val sendIntent = Intent(Intent.ACTION_VIEW)
+            sendIntent.data = Uri.parse("sms:")
+            sendIntent.putExtra("address", "111222333")
+            sendIntent.putExtra("sms_body", textViewName.text)
+            startActivity(sendIntent)
+        }
+
         initListView()
     }
 
@@ -161,4 +169,104 @@ class VerifyTest {
         onView(withId(R.id.textViewName)).check(matches(not(isDisplayed())))
     }
 }
-{% endhighlight %}
+{% endhighlight %}
+
+## UI Automator
+Testy przeprowadzane w `UI Automator` pozwalają na weryfikację zachowania testowanej w aplikacji w interakcjach z innymi aplikacjami lub komponentami systemu. Przebiegają wg podobnego scenariusza co testy w `Espresso`, tzn. znajdowany jest widok, wykonywane są akcje i finalnie następuje sprawdzenie poprawności oczekiwanego stanu. Na wstępie jednak trzeba uzyskać dostęp do testowanego urządzenia poprzez instancję `UiDevice` dzięki czemu możliwe jest znajdowanie i operowanie na widokach oraz manipulowanie stanem urządzania. Dobrą praktyką jest rozpoczynanie testów od głównego ekranu systemowego.
+
+{% highlight kotlin %}
+@RunWith(AndroidJUnit4::class)
+class UIAutomatorTest {
+
+    private val APP_PACKAGE = "pl.androidcode"
+    private val SMS_APP_PACKAGE = "com.google.android.apps.messaging"
+
+    private lateinit var device: UiDevice
+
+    @Before
+    fun startMainActivityFromHomeScreen() {
+        device = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation()) //initialize
+        device.pressHome() //start every test from home screen
+        deviceWait(device.launcherPackageName) //wait for launcher
+
+        //start the app
+        val context = ApplicationProvider.getApplicationContext<Context>()
+        val intent = context.packageManager.getLaunchIntentForPackage(APP_PACKAGE)
+            .apply { addFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK) }
+        context.startActivity(intent)
+        deviceWait(APP_PACKAGE) //wait for app
+    }
+
+    private fun deviceWait(pkg: String) {
+        device.wait(Until.hasObject(By.pkg(pkg).depth(0)), 5000L)
+    }
+
+    //some tests
+}
+{% endhighlight %}
+
+Aby otrzymać dostęp do komponentów widoków aplikacji (widocznych na ekranie) należy uzyskać instancję typu `UiObject` wywołując metodę `findObject` na obiekcie `UiDevice` przekazując jako argument odpowiedni `UiSelector` konstruowany na podstawie m.in. id (`resourceId`), zawartości (`text`) czy nazwy klasy obiektu widoku (`className`). O ile komplet informacji nt widoków testowanej aplikacji dostępny jest z poziomu kodu to w przypadku zewnętrznych aplikacji i komponentów systemu już niekoniecznie. W takim przypadku można posłużyć się narzędziem `UI Automator Viewer` dostępnym w `Android Studio`. Akcje jakie można wykonać to m.in. `click`, `dragTo`, `setText`, `swipeUp`.
+
+{% highlight kotlin %}
+@Test
+fun verifyTypedMessageFromEditText() {
+    //find views by some selectors (known from you app code)
+    val editText = device.findObject(UiSelector().resourceId("${APP_PACKAGE}:id/editTextName"))
+    val buttonAction = device.findObject(UiSelector().text("ACTION").className("android.widget.Button"))
+    val buttonSms = device.findObject(UiSelector().text("SMS").className("android.widget.Button"))
+
+    if(editText.exists() && buttonAction.exists() && buttonSms.exists()) {
+        //do actions
+        editText.setText("message")
+        buttonAction.click()
+        buttonSms.click()
+        deviceWait(SMS_APP_PACKAGE) //wait for expected sms app
+
+        //find view by some selectors (known from UiAutomator Viewer)
+        val messageField = device.findObject(UiSelector().resourceId("${SMS_APP_PACKAGE}:id/compose_message_text"))
+        Assert.assertEquals("message", messageField.text)
+    }
+    else throw UiObjectNotFoundException("Throw when no matching UI element is found")
+}
+{% endhighlight %}
+
+Symulowanie interakcji z elementami kolekcji lub komponentami typu scrollable może odbywać się przy użyciu klas `UiCollection` i `UiScrollable`.
+
+{% highlight kotlin %}
+/*instead of findObject on UiDevice like below UiCollection and UiScrollable can be used
+val listViewItem: UiObject = device.findObject(UiSelector().className("android.widget.ListView")
+    .instance(0).childSelector(UiSelector().text("name1")))*/
+
+@Test
+fun verifyPassedMessageFromCollection() {
+    val buttonSms = device.findObject(UiSelector().text("SMS").className("android.widget.Button"))
+    val collection: UiCollection = UiCollection(UiSelector().className("android.widget.ListView"))
+    val listViewItem: UiObject = collection.getChild(UiSelector().text("name1"))
+
+    if(listViewItem.exists() && buttonSms.exists()) {
+        listViewItem.click()
+        buttonSms.click()
+        deviceWait(SMS_APP_PACKAGE) //wait for expected sms app
+
+        val messageField = device.findObject(UiSelector().resourceId("${SMS_APP_PACKAGE}:id/compose_message_text"))
+        Assert.assertEquals("name1", messageField.text)
+    }
+    else throw UiObjectNotFoundException("Throw when no matching UI element is found")
+}
+
+@Test
+fun verifyPassedMessageFromScrollable() {
+    val buttonSms = device.findObject(UiSelector().text("SMS").className("android.widget.Button"))
+    val scrollable = UiScrollable(UiSelector().className("android.widget.ListView"))
+
+    if(buttonSms.exists()) {
+        scrollable.getChildByText(UiSelector().className("android.widget.TextView"), "name1")
+        buttonSms.click()
+        deviceWait(SMS_APP_PACKAGE) //wait for expected sms app
+
+        val messageField = device.findObject(UiSelector().resourceId("${SMS_APP_PACKAGE}:id/compose_message_text"))
+        Assert.assertEquals("name1", messageField.text)
+    }
+    else throw UiObjectNotFoundException("Throw when no matching UI element is found")
+}
+{% endhighlight %}