MultipleWindowTest.java

package com.google.android.apps.common.testing.ui.espresso.sample;

import static com.google.android.apps.common.testing.ui.espresso.Espresso.onData;
import static com.google.android.apps.common.testing.ui.espresso.Espresso.onView;
import static com.google.android.apps.common.testing.ui.espresso.action.ViewActions.clearText;
import static com.google.android.apps.common.testing.ui.espresso.action.ViewActions.click;
import static com.google.android.apps.common.testing.ui.espresso.action.ViewActions.scrollTo;
import static com.google.android.apps.common.testing.ui.espresso.action.ViewActions.typeText;
import static com.google.android.apps.common.testing.ui.espresso.action.ViewActions.typeTextIntoFocusedView;
import static com.google.android.apps.common.testing.ui.espresso.assertion.ViewAssertions.matches;
import static com.google.android.apps.common.testing.ui.espresso.matcher.RootMatchers.withDecorView;
import static com.google.android.apps.common.testing.ui.espresso.matcher.ViewMatchers.withId;
import static com.google.android.apps.common.testing.ui.espresso.matcher.ViewMatchers.withText;
import static org.hamcrest.Matchers.allOf;
import static org.hamcrest.Matchers.instanceOf;
import static org.hamcrest.Matchers.is;
import static org.hamcrest.Matchers.not;

import com.google.android.apps.common.testing.ui.testapp.R;
import com.google.android.apps.common.testing.ui.testapp.SendActivity;

import android.os.Build;
import android.test.ActivityInstrumentationTestCase2;
import android.test.suitebuilder.annotation.LargeTest;

/**
 * Demonstrates dealing with multiple windows.
 *
 * Espresso provides the ability to switch the default window matcher used in both onView and onData
 * interactions.
 *
 * @see com.google.android.apps.common.testing.ui.espresso.Espresso#onView
 * @see com.google.android.apps.common.testing.ui.espresso.Espresso#onData
 */
@LargeTest
public class MultipleWindowTest extends ActivityInstrumentationTestCase2<SendActivity> {

  @SuppressWarnings("deprecation")
  public MultipleWindowTest() {
    // This constructor was deprecated - but we want to support lower API levels.
    super("com.google.android.apps.common.testing.ui.testapp", SendActivity.class);
  }

  @Override
  public void setUp() throws Exception {
    super.setUp();
    // Espresso will not launch our activity for us, we must launch it via getActivity().
    getActivity();
  }

  public void testInteractionsWithAutoCompletePopup() {
    if (Build.VERSION.SDK_INT < 10) {
      // Froyo's AutoCompleteTextBox is broken - do not bother testing with it.
      return;
    }
    // Android's Window system allows multiple view hierarchies to layer on top of each other.
    //
    // A real world analogy would be an overhead projector with multiple transparencies placed
    // on top of each other. Each Window is a transparency, and what is drawn on top of this
    // transparency is the view hierarchy.
    //
    // By default Espresso uses a heuristic to guess which Window you intend to interact with.
    // This heuristic is normally 'good enough' however if you want to interact with a Window
    // that it does not select then you'll have to swap in your own root window matcher.


    // Initially we only have 1 window, but by typing into the auto complete text view another
    // window will be layered on top of the screen. Espresso ignore's this layer because it is
    // not connected to the keyboard/ime.
    onView(withId(R.id.auto_complete_text_view))
        .perform(scrollTo())
        .perform(typeText("So"));

    // As you can see, we continue typing oblivious to the new window on the screen.
    // At the moment there should be 2 completions (South China Sea and Southern Ocean)
    // Lets narrow that down to 1 completion.
    onView(withId(R.id.auto_complete_text_view))
        .perform(typeTextIntoFocusedView("uth "));

    // Now we may want to explicitly tap on a completion. We must override Espresso's
    // default window selection heuristic with our own.
    onView(withText("South China Sea"))
        .inRoot(withDecorView(not(is(getActivity().getWindow().getDecorView()))))
        .perform(click());

    // And by clicking on the auto complete term, the text should be filled in.
    onView(withId(R.id.auto_complete_text_view))
        .check(matches(withText("South China Sea")));


    // NB: The autocompletion box is implemented with a ListView, so the preferred way
    // to interact with it is onData(). We can use inRoot here too!
    onView(withId(R.id.auto_complete_text_view))
        .perform(clearText())
        .perform(typeText("S"));

    // Which is useful because some of the completions may not be part of the View Hierarchy
    // unless you scroll around the list.
    onData(allOf(instanceOf(String.class), is("Baltic Sea")))
        .inRoot(withDecorView(not(is(getActivity().getWindow().getDecorView()))))
        .perform(click());

    onView(withId(R.id.auto_complete_text_view))
        .check(matches(withText("Baltic Sea")));
  }

}