Drink Espresso During Android Testing - Introduction

@RunWith(AndroidJUnit4::class)
class LoginActivityTest {
@Rule @JvmField
val mActivityRule =
ActivityTestRule(LoginActivity::class.java)
@Test
fun shouldVerifyEmptyPassword() {
onView(withId(R.id.edit_text_username))
.perform(typeText("Alex"),
onView(withId(R.id.login_button))
.perform(click())
onView(withId(R.id.password_text_layout))
.check(matches(
withError(`is`("Please enter a password"))))
}
}

View Slide

@Rule @JvmField
val mActivityRule = ActivityTestRule
(LoginActivity::class.java)
@Test
.perform(click())
.check(matches(
}
}

View Slide

@Rule @JvmField
val mActivityRule = ActivityTestRule(LoginActivity::class.java)
@Test
.perform(click())
.check(matches(
}
}

View Slide

@Rule @JvmField
@Test
.perform(click())
.check(matches(
}
}

View Slide

@Rule @JvmField
@Test
.perform(click())
.check(matches(
}
}

View Slide

@Rule @JvmField
@Test
.perform(click())
.check(matches(withError(`is`(
"Please enter a password"))))
}
}
* withError – a custom matcher

View Slide

onView(withId(R.id.download))
.perform(click())
onView(withId(android.support.design.R.id.snackbar_text))
.check(matches(
withText(R.string.downloading_movie_info)))

View Slide

What is an AdapterView and how it works?
java.lang.Object
↳ android.view.View
↳ android.view.ViewGroup
↳ android.widget.AdapterView

GridView ListView
Spinner

View Slide

Espresso
onData(ObjectMatcher)
.DataOptions
.perform(ViewAction)
.check(ViewAssertion)

View Slide

onData – ArrayAdapter
onData(allOf(`is`(instanceOf(String::class.java)),
`is`("Americano")))
val arrayAdapter = ArrayAdapter(
[email protected],
android.R.layout.simple_list_item_1,
android.R.id.text1,
coffeeList)

View Slide

onData – custom adapter
@Test
fun clickCoffeeItem() {
...
onData(withCoffee(espresso))
.inAdapterView(withId(R.id.detail_list))
.perform(click());
}
class CoffeeAdapter : BaseAdapter() {
...
override fun getItem(position: Int): Any {
return mOrderedCoffee.keys.toTypedArray()[position]
}
}

View Slide

fun withCoffee(expected: Coffee) : Matcher {
return object : BoundedMatcher(Coffee::class.java) {
override fun describeTo(description: Description) {
description.appendText("has value: $expected")
}
override fun matchesSafely(item: Coffee): Boolean {
return item == expected
}
}
}

View Slide

RecyclerView
java.lang.Object
↳ android.view.View
↳ android.view.ViewGroup
↳ android.support.v7.widget.RecyclerView
It is not an AdapterView

View Slide

RecyclerViewActions
ü actionOnHolderItem
ü actionOnItem
ü actionOnItemAtPosition
ü scrollTo
ü scrollToHolder
ü scrollToPosition
onView(withId(R.id.recyclerView))
.perform(actionOnItemAtPosition(3, click()));

View Slide

IdlingResource
class ServiceIdlingResource : IdlingResource {
lateinit var mResourceCallback : ResourceCallback
override fun getName(): String {
return ServiceIdlingResource::class.simpleName!!
}
override fun isIdleNow(): Boolean {
val isIdle = !isIntentServiceRunning()
if (isIdle) {
mResourceCallback.onTransitionToIdle()
}
return isIdle
}
override fun registerIdleTransitionCallback(callback: ResourceCallback) {
mResourceCallback = callback
}
fun isIntentServiceRunning() : Boolean { ... }
}
http://blog.sqisland.com/2015/04/espresso-custom-idling-resource.html

View Slide

Using IdlingResource
@Before
fun setUp() {
mLoadingIdlingResource = ServiceIdlingResource()
IdlingRegistry.getInstance().register(mLoadingIdlingResource)
}
@Test
fun shouldVerifyMessageDuringDownloadingMoviesInfo() {
onView(withId(R.id.fab))
.perform(click())
.check(matches(withText(R.string.downloading_movie_info)))
}
@After
fun tearDown() {
IdlingRegistry.getInstance().unregister(mLoadingIdlingResource)
}

View Slide

CountingIdlingResource
class MovieDetailActivity : AppCompatActivity() {
val mCountingIdlingResource = CountingIdlingResource(LOADING_MOVIE_DETAILS)
companion object {
private const val LOADING_MOVIE_DETAILS = "loading_movie_details"
}
fun loadMore() {
...
mCountingIdlingResource.increment()
}
fun showMovies() {
...
mCountingIdlingResource.decrement()
}
}

View Slide

Using CountingIdlingResource
@Before
fun setUp() {
mLoadingIdlingResource = mMovieDetailActivityRule.
activity.mCountingIdlingResource
IdlingRegistry.getInstance().register(mLoadingIdlingResource)
}
@Test
fun shouldVerifyMessageDuringDownloadingMoviesInfo() {
onView(withId(R.id.fab))
.perform(click())
.check(matches(withText(R.string.downloading_movie_info)))
}
@After
fun tearDown() {
IdlingRegistry.getInstance().unregister(mLoadingIdlingResource)
}

View Slide

Configure a custom intent
@Rule @JvmField
val mMovieDetailActivityRule = ActivityTestRule(
MovieDetailActivity::class.java,
true,
false) // is activity launch?
@Test
fun `Should display message during downloading movie info`() {
val context = InstrumentationRegistry.getTargetContext()
val movieIntent = Intent(context, MovieDetailActivity::class.java)
movieIntent.putExtra("movie_id", ANNABELLE_MOVIE)
mMovieDetailActivityRule.launchActivity(movieIntent)
...
}
App data: https://www.themoviedb.org

View Slide

Handle animation inside the app
val animatorSpeed = Settings.Global.getFloat(
contentResolver,
SETTINGS_NAME,
0.0f)

ü Settings.Global.ANIMATOR_DURATION_SCALE
ü Settings.Global.TRANSITION_ANIMATION_SCALE
ü Settings.Global.WINDOW_ANIMATION_SCALE

View Slide

UI AutomatorViewer
Android Studio
Tools / Android / Android Device Monitor
Application
{ANDROID_SDK} / tools / uiautomatorviewer

View Slide

UiAutomator
Android 4.3 (API 18)
Interacting with any application
Interacting with a system

View Slide

Basic UI Automator components
ü UiDevice
ü UiCollection
ü UiObject / UiObject2
ü UiScrollable
ü UiSelector
ü Configurator

View Slide

UiDevice
ü Press "Home" button
mUiDevice.pressHome()
ü Press "Back" button
mUiDevice.pressBack()
ü Press “Power” button
mUiDevice.wakeUp()
ü Click at arbitrary coordinates
mUiDevice.click(300, 215)
ü Open the notifications
mUiDevice.openNotification()

View Slide

Test of calculator application
class CalculatorAppTest {
lateinit var mDevice: UiDevice
@Before fun setUp() {
mDevice = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation())
mDevice.pressHome()
mDevice.findObject(By.desc("Apps list")).click()
mDevice.findObject(By.desc("Calculator")).click()
}
@Test
fun shouldSumThreeAndFive() {
mDevice.wait(Until.hasObject(By.text("5")), 3_000L)
val five = mDevice.findObject(By.text("5"))
val plus = mDevice.findObject(By.text("+"))
val three = mDevice.findObject(By.text("3"))
val equal = mDevice.findObject(By.text("="))
five.click()
plus.click()
three.click()
equal.click()
val result = mDevice.findObject(By.res("com.android.calculator2", "result"))
assertEquals("8", result.text)
}
@After fun tearDown() {
mDevice.pressBack()
}
}

View Slide

mDevice.pressHome()
}
@Test
five.click()
plus.click()
three.click()
equal.click()
}
mDevice.pressBack()
}
}

View Slide

mDevice.pressHome()
}
@Test
five.click()
plus.click()
three.click()
equal.click()
}
mDevice.pressBack()
}
}

View Slide