Espresso 自动化测试使用
Espresso是一个Android UI测试框架,由三部分组成
- ViewMachers:寻找View
- ViewActions: 执行交互事件
- ViewAssertions:检验测试结果
添加加依赖库
android{
defaultConfig{
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}
}
dependencies{
androidTestCompile 'com.android.support:support-annotations:24.1.1'
androidTestCompile 'com.android.support.test:runner:0.5'
androidTestCompile 'com.android.support.test:rules:0.5'
androidTestCompile 'com.android.support.test.espresso:espresso-core:2.2.2'
}
-
com.android.support:support-annotations
是注解库 -
com.android.support.test:runner
一个非捆绑的测试运行库 -
com.android.support.test:rules
一套使用在AndroidJUnitRunner的规则库 -
com.android.support.test.espresso:espresso-core
UI测试的核心库
使用Espresso测试
-
测试的UI对象TestActivity
-
布局文件 activity_test.xml
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical"> <TextView android:id="@+id/text" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="test"/> <Button android:id="@+id/btn" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="botton" </LinearLayout>
-
TestActivity
public class TestActivity extends Activity{ TextView text; Button btn; public void onCreate(Bundle data){ setContentView(R.layout.activity_test); text = (TextView)findViewById(R.id.text); btn = (Button)findViewById(R.id.btn); btn.setOnClickListener(view -> text.setText("finish")); } }
-
-
在androidTest文件目录下建一个测试类
@RunWith(AndroidJUnit4.class)
public class UITest{
//设置初始启动测试Activity,并启动
@Rule
public ActivityTestRule<TestActivity> mActivityRule
= new ActvitiyTestRule<>(TestActivity.class);
@Test
public void testClick(){
Espresso.onView(ViewMatchers.withId(R.id.btn)).preform(ViewActions.click()).check(ViewAssertions.matches(ViewMatchers.withText("finish")));
}
}
ActivityTestRule 这个rule是用来测试单个Activity的,Activity将在@Test和@Before前启动
-
当你启动的Activity需要带参数时
@RunWith(AndroidJUnit4.class)
public class UITest{
//设置初始启动测试Activity,ActivityTestRule的构造函数的第三个参数是否启动Activity
@Rule
public ActivityTestRule<TestActivity> mActivityRule
= new ActvitiyTestRule<>(TestActivity.class,false,false);
@Test
public void startActivity(){
Context context = InstrumentationRegistry.getInstrumentation().getTargetContext();
Intent intent = new Intent(context,TestActivity.class);
intent.putExtra("id",2);
mActivityRule.launchActivity(intent);
}
@Test
public void testClick(){
Espresso.onView(ViewMatchers.withId(R.id.btn)).perform(ViewActions.click()).check(ViewAssertions.matches(ViewMatchers.withText("finish")));
}
}
Espresso
-
AdapterView、ListView、GridView 事件测试
- ListView 的点击事件
//点击指定数据所在的 Item Area area = new Area(); onData(allOf(is(instanceOf(Area.class)),is(area))).perform(click()); //点击指定位置的 Item onData(is(instanceOf(Area.class))).atPosition(position).perform(click()); //使用自定义匹配数据的方法 onData(allOf(is(instanceOf(Area.class)),withAreaId("12"))).perform(click()); //点击特殊的 Item,如这里的 HeadView onData(is(instanceOf(Area.class))).onChildView(instanceOf(HeadView.class)).perform(click());
withAreaId 方法是返回一个自定义的Matcher,后面会讲到Matcher的自定义
-
RecyclerView 事件测试
测试 RecyclerView 需要使用RecyclerViewActions,使用该类需要在build.Gradle文件引入该库
RecyclerViewActions的使用androidTestCompile 'com.android.support.test.espresso:espresso-contrib:2.2.2'
//点击ID为recycler的RecyclerView的第2个位置的子View onView(withId(R.id.recycler)).perform(RecyclerViewActions.actionOnItemAtPosition(2,click())); //以下是RcyclerViewActions的一些Action方法 //操作匹配的HolderView actionOnHolderItem (Matcher<VH> viewHolderMatcher,ViewAction viewAction) //操作匹配的Item actionOnItem (Matcher<View> itemViewMatcher, ViewAction viewAction) //操作指定位置的Item actionOnItemAtPosition (int position,ViewAction viewAction) //移动到匹配的Item位置 scrollTo (Matcher<View> itemViewMatcher) //移动到匹配的ViewHolder的位置 scrollToHolder (Matcher<VH> viewHolderMatcher) //移动到指定位置 scrollToPosition (int position)
-
自定义Matcher
定义前面提到的AdapterView的WithAreaId的Matcher
public class CustomViewMatchers{ public static Matcher<Object> withAreaId(String id){ public static Matcher<Object> withAreaId(final String areaId){ return new BoundedMatcher<Object, Area>(Area.class) { @Override public void describeTo(Description description) { description.appendText("this a Matcher as match areaId"); } @Override protected boolean matchesSafely(Area item) { return item.getAreaId().equals(areaId); } }; } } public static Matcher<View> withStartText(String startStr){ return new BaseMatcher<View>() { @Override public boolean matches(Object item) { TextView text = (TextView) item; return text.getText().toString().startsWith(startStr); } @Override public void describeTo(Description description) { description.appendText("this is a Matcher as match head of String"); } }; } }
-
自定义ViewAction
public class CustomViewActions{
static final class SeekBarAction implements ViewAction{
private int progress;
public SeekBarAction(int progress){
this.progress = progress;
}
@Override
public Matcher<View> getConstaints(){
return allOf(ViewMatchers.isAssignableFrom(SeekBar.class),ViewMatchers.isDisplayed());
}
@Override
public String getDescription(){
return "this is a seek ation with SeekBar";
}
@Override
public void perform(UiController uiController,View view){
SeekBar seekBar = (SeekBar)view;
seekBar.seekTo(progress);
}
}
}
-
异步操作测试
需要自定义 IdlingResouce,看了几篇博客描述的都有问题,建议直接参考Google官方项目 IdlingResourceSample
IdlingResource的使用已经补上,由于这篇文章篇幅已经较长,故在专门写了一篇
Espresso IdlingResource 测试延时操作的使用
ps:以上是本人对Espress的使用经验,有什么问题可以评论
参考资料:
- https://github.com/googlesamples/android-testing/
- http://gavinliu.cn/2015/12/30/Android-%E6%B5%8B%E8%AF%95%E6%A1%86%E6%9E%B6%E4%B9%8B-UI-Testing-Espresso/
- https://google.github.io/android-testing-support-library/
- http://tbfungeek.github.io/2016/07/01/Android-%E8%BF%9B%E9%98%B6%E4%B9%8B%E8%87%AA%E5%8A%A8%E5%8C%96%E6%B5%8B%E8%AF%95Espreso/
- http://ztzt123.cn/android/2016/08/19/Android%E5%8D%95%E5%85%83%E6%B5%8B%E8%AF%95%E5%92%8CUI%E6%B5%8B%E8%AF%95.html
- https://developer.android.com/reference
网友评论