Espresso的详细使用

本篇详细介绍了Espresso的使用方式.

Espresso 测试代码位置和静态导入

Espresso 测试代码必须放在 app/src/androidTest 目录下.

为了简化 Espresso API 的使用, 强烈建议使用以下静态导入. 可以允许在没有类前缀的前提下访问这些静态方法.

import static android.support.test.espresso.Espresso.onView;
import static android.support.test.espresso.action.ViewActions.click;
import static android.support.test.espresso.action.ViewActions.closeSoftKeyboard;
import static android.support.test.espresso.action.ViewActions.typeText;
import static android.support.test.espresso.assertion.ViewAssertions.matches;
import static android.support.test.espresso.matcher.ViewMatchers.withId;
import static android.support.test.espresso.matcher.ViewMatchers.withText;

ViewMatcher 的使用

查找一个 View, 需要使用 onView() 方法和视图匹配器(view matcher)来选择正确的 View. 如果你使用的是 AdapterView, 需要使用 onData() 方法而不是 onView()方法. onView() 返回的是一个 ViewInteraction 类型的对象, onData() 返回的是一个 DataInteraction 类型的对象.

表1 中介绍了可用的匹配器.

Espresso matchers

表 1 Espresso 匹配器

执行操作(perform action)

ViewInteraction 和 DataInteraction 可以通过 perform 方法和 ViewActions 类型的对象指定某种操作. ViewActions 类为最常见的操作了提供了相应的辅助方法. 像:

  • ViewActions.click()
  • ViewActions.typeText()
  • ViewActions.pressKey()
  • ViewActions.clearText()
  • ViewActions.replaceText()

perform() 方法还会再次返回一个 ViewInteraction 的对象, 也就是说你可以执行更多的操作或者验证结果. 而且你也可以通过 perform() 方法的可变参数来指定多个操作.

验证测试结果

调用 ViewInteraction.check() 方法可以断言一个 View 的状态. 这个方法需要一个 ViewAssertion 类型的对象作为参数. ViewAssertion 类提供了用于创建这些对象的辅助方法.

  • maches() - Hamcrest 匹配器
  • doesNotExist() - 断言选中的 View 不存在

你也可以使用强大的 Hamcrest 匹配器. 下面给出了部分示例:

onView(withText(startsWith("ABC"))).perform(click());// 1.

onView(withText(endsWith("YYZZ"))).perform(click()); // 2.

onView(withId(R.id.viewId)).
  check(matches(withContentDescription(containsString("YYZZ")))); // 3.

onView(withText(equalToIgnoringCase("xxYY"))).perform(click()); // 4.

onView(withText(equalToIgnoringWhiteSpace("XX YY ZZ"))).perform(click()); // 5.

onView(withId(R.id.viewId)).check(matches(withText(not(containsString("YYZZ"))))); // 6.

① 匹配以文本 "ABC" 开头的 View

② 匹配以文本 "YYZZ" 结尾的 View

③ 匹配指定 id View 的且检查文本内容包含 "YYZZ"

④ 匹配一个含有指定字符串的 View, 并且该字符串忽略大小写

⑤ 匹配一个含有指定字符串的 View, 并且该字符串忽略空白字符

⑥ 匹配指定 id View 的且检查文本内容不包含 "YYZZ"

访问 instrumentation API

通过 InstrumentationRegistry.getTargetContext() 可以访问到测试应用的上下文, 例如你想使用字符串 id 而不是 R.id, 下面的方法可以帮助你实现:

/**
 * Created by zhanglulu on 2018/3/6.
 */
@RunWith(AndroidJUnit4.class)
public class EspressoTest2ActivityTest {

    @Rule
    public ActivityTestRule<EspressoTest2Activity> mRule =
            new ActivityTestRule<EspressoTest2Activity>(
                    EspressoTest2Activity.class);

    @Test
    public void buttonShouldUpdateText(){
        onView(withId(R.id.resultView)).perform(click());
        onView(withId(getResourceId("Click"))).check(matches(withText("Done")));
    }

    /**
     * 根据 id 字符串获取真实 id
     * @param idStr
     * @return
     */
    private static int getResourceId(String idStr) {
        Context targetContext = InstrumentationRegistry.getTargetContext();
        String packageName = targetContext.getPackageName();
        return targetContext.getResources().getIdentifier(idStr, "id", packageName);
    }
}

配置Activity的启动 Intent

如果你给 ActivityTestRule 构造方法的第三个参数指定为 false, 则可以配置启动 Intent, 并手动启动测试 Activity.

/**
 * Created by zhanglulu on 2018/3/6.
 */
@RunWith(AndroidJUnit4.class)
public class EspressoTest2ActivityTest {

    @Rule
    public ActivityTestRule<EspressoTest2Activity> mRule =
            new ActivityTestRule<EspressoTest2Activity>(
                    EspressoTest2Activity.class, true, false);

    @Test
    public void demonstrateIntentPrep() {
        Intent intent = new Intent();
        intent.putExtra("input", "Test");
        mRule.launchActivity(intent);
        onView(withId(R.id.resultView)).check(matches(withText("Test")));
    }
}

Adapter Views

AdapterView 是一种特殊的组件, 它可以动态的从 Adapter 中加载数据. 只有一部分数据在 View 层次结构中有真实的 View. onView() 不会为这些数据找到相应的 View. 而 onData() 可以与 Adapter 进行交互, 找到对应的 View, 例如 ListView. 下面给出部分示例:

@Test
public void testList() {
    // 点击 ListView 中文本为 "测试 15" 的 item
    onData(allOf(is(instanceOf(String.class)), is("测试 30")))
            .perform(click());
    onData(allOf(is(instanceOf(String.class)), is("测试 1")))
            .perform(click());
    onData(allOf(is(instanceOf(String.class)), is("测试 49")))
            .perform(click());
}

Espresso 测试添加权限

可以通过 instrumentation API 给你的测试执行授予权限的操作.如下面示例:

@Before
public void grantPermission() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        getInstrumentation().getUiAutomation().executeShellCommand(
                "pm grant " + getInstrumentation().getTargetContext().getPackageName()
                        + " android.permission.CALL_PHONE");
    }
}

Espresso UI Recorder

Android Studio 在测试菜单栏上提供了一个 Run ▸ Record Espresso Test 的功能, 它可以记录下你与应用程序的交互并从中创建 Espresso 测试.

run recorder

点击运行,之后 Android Studio 将记录下你与应用的交互行为,并生成测试代码.

Recorder Test

访问当前的 Activity

你还可以访问正在进行测试的 Activity 对象,并调用它的方法. 例如,你有下面的 TestConfigureActivity, 并存在一个方法 configureActivity().

public class TestConfigureActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_test_configure);
    }
    // 外部调用
    public void configureActivity(String Uri) {
        // do something with this
    }

    public void onClick(View view) {
        startActivity(new Intent(this, SecondActivity.class));
    }
}

如果你想在测试方法中得到这个 Activity 并且执行里面的方法, 你可以通过 ActivityTestRule 来获取, 示例如下:

@Test
public void useAppContext() throws Exception{
    TestConfigureActivity activity = mRule.getActivity();
    activity.configureActivity("https://testurl");
    //do more
}

并且你也可以重写 ActivityTestRule 类来配置你的测试 Activity.例如:

@Rule
    public ActivityTestRule<TestConfigureActivity> mRule =
            new ActivityTestRule<TestConfigureActivity>(TestConfigureActivity.class){
                @Override
                protected void beforeActivityLaunched() {
                    super.beforeActivityLaunched();
                    //Activity 启动前做些事情
                }
    
                @Override
                protected void afterActivityLaunched() {
                    super.afterActivityLaunched();
                    //Activity 启动后做些事情
                }
            };

你甚至可以拿到前台的 Activity 的实例.这里着重说明一下, 你所测试的 Activity 不一定都在前台显示, 例如,你从当前测试的 Activity (也就是你在 ActivityTestRule 传入的 Activity) 跳转到另外的一个 Activity, 此时在前台的 Activity 就是另外的一个 Activity. 这个时候就可以通过 ActivityLifecycleMonitorRegistry 来获取前台的 Activity, 示例如下:

@Test
public void navigate() {
    onView(withText("Next")).perform(click());
    Activity activity = getActivityInstance();
    boolean b = (activity instanceof SecondActivity);
    assertTrue(b);
    // do more
}

public Activity getActivityInstance() {
    final Activity[] activity = new Activity[1];
    InstrumentationRegistry.getInstrumentation().runOnMainSync(() -> {
        Activity currentActivity = null;
        Collection resumedActivities =
                ActivityLifecycleMonitorRegistry.getInstance().getActivitiesInStage(RESUMED);
        if (resumedActivities.iterator().hasNext()){
            currentActivity = (Activity) resumedActivities.iterator ().next();
            activity[0] = currentActivity;
        }
    });
    return activity[0];
}

需要注意的是 ActivityLifecycleMonitorRegistry 并不是标准的 API, 所以可能在后期名称会发生变化.

运行 Espresso 测试输出测试报告

  1. 使用 Android Studio

右击你的测试类, 并点击运行就 OK 了.

execute test for as
  1. 使用 Gradle

通过 Gradle 执行 connectedCheck Task 可以执行测试目录下所有的测试用例.

excute test for gradle

执行结束后将会在 app/build/reports 目录下生成测试报告, 点击打开 index.html 即可查看.

Test Reports

检查 Taost

下面是一个点击 Item ,并检查 Toast 是否弹出的测试.

@Test
public void testToast() {
    onData(allOf(instanceOf(String.class), is("测试 20"))).perform(click());
    onView(withText(startsWith("点击")))
            .inRoot(withDecorView(not(is(mRule.getActivity().getWindow().getDecorView()))))
            .check(matches(isDisplayed()));
}

通过Espresso Intents模拟Intent

Espresso 也提供了模拟 Intent 的功能. 它可以检查一个 Activity 是否正常发出一个正确的 Intent.如果它接收了正确 Intent 则测试通过.

Espresso Intents 通过 com.android.support.test.espresso:espresso-intents 依赖提供.

使用 Espresso Intents 必须使用 IntentTestRule 而不是 ActivityTestRule.下面是一个简单的示例:

/**
 * Created by zhanglulu on 2018/3/7.
 */
@RunWith(AndroidJUnit4.class)
public class TestIntent {

    @Rule
    public IntentsTestRule<EspressoTest1Activity> mIntentTestRule =
            new IntentsTestRule<EspressoTest1Activity>(EspressoTest1Activity.class);

    @Test
    public void triggerIntentTest() {
        onView(withId(R.id.switchActivity)).perform(click());
        intended(allOf(
                hasAction(Intent.ACTION_CALL),
                hasData("123456789"),
                toPackage(InstrumentationRegistry.getTargetContext().getPackageName()),
                hasExtra("input", "Test")
        ));
    }
}

更多详细内容请移步: https://developer.android.com/training/testing/espresso/intents.html#matching

敲行代码再睡觉
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 199,175评论 5赞 466
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 83,674评论 2赞 376
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 146,151评论 0赞 328
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 53,597评论 1赞 269
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 62,505评论 5赞 359
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 47,969评论 1赞 275
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 37,455评论 3赞 390
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,118评论 0赞 254
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 40,227评论 1赞 294
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,213评论 2赞 317
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,214评论 1赞 328
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 32,928评论 3赞 316
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 38,512评论 3赞 302
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,616评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,848评论 1赞 255
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 42,228评论 2赞 344
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 41,772评论 2赞 339

推荐阅读更多精彩内容