自定义视图匹配器

---

Espresso 提供了各种选项来创建我们自己的自定义视图匹配器，它基于Hamcrest匹配器。自定义匹配器是一个非常强大的概念，可以扩展框架，也可以根据我们的口味定制框架。编写自定义匹配器的一些优点如下：

• 利用我们自己的自定义视图的独特功能

• 自定义匹配器有助于基于AdapterView 的测试用例与不同类型的底层数据进行匹配。

• 通过结合多个匹配器的特征来简化当前的匹配器

当需求出现时，我们可以创建新的匹配器，这非常容易。让我们创建一个新的自定义匹配器，它返回一个匹配器来测试TextView的 id 和文本。

Espresso 提供以下两个类来编写新的匹配器 -

• 类型安全匹配器

• 有界匹配器

这两个类本质上相似，只是BoundedMatcher透明地处理将对象转换为正确的类型，而无需手动检查正确的类型。我们将使用BoundedMatcher类创建一个新的匹配器withIdAndText。让我们检查一下编写新匹配器的步骤。

• 在app/build.gradle文件中添加以下依赖项并同步它。

dependencies {
   implementation 'androidx.test.espresso:espresso-core:3.1.1'
}

• 创建一个新类以包含我们的匹配器（方法）并将其标记为最终类

public final class MyMatchers {
}

• 使用必要的参数在新类中声明一个静态方法，并将 Matcher<View> 设置为返回类型。

public final class MyMatchers {
   @NonNull
   public static Matcher<View> withIdAndText(final Matcher<Integer>
   integerMatcher, final Matcher<String> stringMatcher) {
   }
}

• 在静态方法中使用以下签名创建一个新的 BoundedMatcher 对象（也返回值），

public final class MyMatchers {
   @NonNull
   public static Matcher<View> withIdAndText(final Matcher<Integer>
   integerMatcher, final Matcher<String> stringMatcher) {
      return new BoundedMatcher<View, TextView>(TextView.class) {
      };
   }
}

• 重写BoundedMatcher对象中的describeTo和matchesSafely方法。describeTo 有一个类型为Description的参数，没有返回类型，它用于有关匹配器的错误信息。matchesSafely有一个 TextView 类型的参数，返回类型为boolean，用于匹配视图。

最终版本的代码如下：

public final class MyMatchers {
   @NonNull
   public static Matcher<View> withIdAndText(final Matcher<Integer>
   integerMatcher, final Matcher<String> stringMatcher) {
      return new BoundedMatcher<View, TextView>(TextView.class) {
         @Override
         public void describeTo(final Description description) {
            description.appendText("error text: ");
            stringMatcher.describeTo(description);
            integerMatcher.describeTo(description);
         }
         @Override
         public boolean matchesSafely(final TextView textView) {
            return stringMatcher.matches(textView.getText().toString()) &&
            integerMatcher.matches(textView.getId());
         }
      };
   }
}

• 最后，我们可以使用 mew 匹配器来编写测试用例，如下所示，

@Test
public void view_customMatcher_isCorrect() {
   onView(withIdAndText(is((Integer) R.id.textView_hello), is((String) "Hello World!")))
      .check(matches(withText("Hello World!")));
}