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

敲行代码再睡觉

阅读更多
版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/u013144863/article/details/79959747
文章标签: Espresso
个人分类: Android测试
想对作者说点什么? 我来说一句

没有更多推荐了,返回首页

关闭
关闭
关闭