Robotium 自动化测试
Robotium 自动化测试
一、Setup
Android Studio环境下,在所要测试的Module的build.gradle文件下添加,
compile ‘com.jayway.android.robotium:robotium-solo:5.4.1’
然后Sync下。
二、Start
Robotium即是对Instrumentation框架方法的封装,所以使用之前需要继承测试类,重写构造器,setUp()和tearDown()方法。
public class SplashActivityTest extends ActivityInstrumentationTestCase2 {
private Solo solo;
public SplashActivityTest() throws ClassNotFoundException {
super(SplashActivity.class);
}
@Override
public void setUp() throws Exception {
super.setUp();
solo = new Solo(getInstrumentation());
getActivity();
}
@Override
public void tearDown() throws Exception {
solo.finishOpenedActivities();
super.tearDown();
}
}
其中继承的是ActivityInstrumentationTestCase2测试类。ActivityInstrumentationTestCase2测试类主要用于跨Activity的测试。(测试类的关系和架构见附页1)
其中
solo = new Solo(getInstrumentation());
solo.finishOpenedActivities();
是Robotium框架独有的。
测试方法必须是public的,且以test开头。这是因为用的是Junit3框架。
public void testRun() {}
三、Use
我们所会用到的API主要来自于四个部分:
- Robotium框架核心类Solo
- Instrumentation框架下的ActivityInstrumentationTestCase2类
- unit3下的断言方法
- UI组件的getXX或findXX方法
这里我们只单独简单说明Solo类的API。
Solo类是Robotium中核心类,几乎所有的测试方法都是调用它的方法实现。
1.getXX() 匹配方法
一般使用getView(int id),getText(String text)匹配想要操作的组件,如果匹配不到,还可以尝试getButton(),getImage()等
// getCurrentActivity()方法返回的是界面显示的Activity。
2.action() 操作方法
- clickOnView(),clickOnText()
- clearEditText(),enterText()
- clickInList(),clickInRecyclerView()
- scrollDown(),scrollViewToSide()(如果是ListView等,这里不推荐使用,不如直接使用moveTo等方法)
- goBack()
3.ssert()/search() 断言方法
- assert:只有solo. assertCurrentActivity() 方法
- search()返回布尔值,用于逻辑判断,断言。
- searchXXX(),waitXXX() 与assertEqual() 方法配合。
4.waitXX(,time) 等待方法
waitForActivity()等,返回布尔值。
在time时间内条件成立,立即执行下一步,不一定非要等待time时间。
同时我们可以使用返回false的waitXX方法作为稳定的定时器使用,我常常用waitForEmptyActivityStack()。
三个作用:等待程序响应,逻辑判断,放缓测试速度
备注:waitXX方法的扩展:waitForCondition()用来支持所有判断条件,实例见下:
solo.waitForCondition(new myCondition(viewGroup), 3000)
class myCondition implements Condition {
Object viewGroup;
myCondition(Object viewGroup) {
this.viewGroup = viewGroup;
}
@Override
public boolean isSatisfied() {
return viewGroup != null;
}
}
四、practice
SplashActivity.java(这里难点主要是对listView或RecyclerView组件的遍历和判断条件的选择)
需求:
1、从启动页进入
2、切换城市,遍历所有城市
3、搜索1-9
4、如果搜索结果返回多个匹配值,遍历所有匹配值。
5、如果进入站点详情,遍历所有路线,点击收藏按钮并取消收藏
6、如果进入线路详情,遍历所有站点,刷新,然后换向后,重复一遍换向前操作。
1、从启动页进入
测试进入第一个的界面即我们绑定的界面
public SplashActivityTest() throws ClassNotFoundException {
super(SplashActivity.class);
}
这里类名是不是这个类无所谓,但构造方法中调用你想要进入的类。
2、切换城市,遍历所有城市
由于城市列表是ListView或者RecyclerView,数据对我们是未知的,布局是可变的,我们不能采用直接clickOnText,或者clickOnView进入某个城市。
对于ListView或者RecyclerView解决办法有三种,具体使用看具体情况:
a、通过遍历,获得所有城市集合,然后调用clickOnText。
获得所有城市集合:
/**
* 在CityChooseActivity界面内得到城市列表
*
* @return 城市列表
*/
private String[] getCities() {
solo.clickOnView(solo.getView(R.id.cll_mod_main_tab_mine));
solo.clickOnView(solo.getView(R.id.cll_row_city));
if (solo.waitForActivity(CityChooseActivity.class, 3000)) {
solo.waitForEmptyActivityStack(3000);
StickyListHeadersListView stickyLv =(StickyListHeadersListView) solo.getCurrentActivity().findViewById(R.id.cll_city_change_list);
List cities = new ArrayList();
for (int i = 3; i < stickyLv.getAdapter().getCount(); i++) {
City city = (City) stickyLv.getAdapter().getItem(i);
cities.add(city.getCityName());
}
solo.goBack();
return (String[]) cities.toArray(new String[cities.size()]);
} else {
solo.goBack();
return new String[]{"天津", "北京"};
}
clickOnText方法有三个特点:
1)特别稳定,一般都能找到相应的view,无论view被包裹多少层。
2)如果text没有显示或者所在Item初始化,方法会使ListView滚动,直到找到该View。
当然可以设置是否滚动查找。
3)由于查找该View的机制或者存在两个以上相同Text的View,默认选择第一个,可以设置选第几个。
但是这里我们使用
solo.clickOnView(solo.getView(R.id.cll_search_section));
solo.clearEditText((EditText) solo.getView(R.id.frame_toolbar_search_query));
solo.enterText((EditText) solo.getView(R.id.frame_toolbar_search_query), city);
solo.clickInList(1);
借用程序的功能,同时测试了这个功能。
但是这种方法的缺陷一是,必须首先进入ListView所在的界面,初始化ListrView后,才能得到城市集合,否则只是一个空集合;二是有些组件无法通过遍历获得城市集合。
b、clickInList ()或者clickInRecyclerView()
解决方法1的缺陷,但缺点是:
1)方法内部的限制如果触发事件并没有绑定到Item上,二是item的子View上,可能无法触发事件。
2)方法参数为可见child的index,需要对不同界面进行position到index的转换和组件滚动。
3)如果一个Item有两个监听事件,比如站点详情的收藏,无法触发。
(注意:参数从1开始)
我在对多结果的遍历和线路详情中遍历所有路线使用这种方法,详细使用会在下文中说明。
c、通过给定的组件,通过findLastVisibleItemPosition或者findViewByPosition找到目标View,再找到具体子View,使用clickOnView(targetView);
终极方法(clickOnScreen除外),几乎可以解决所有需求,但是特别麻烦而且不稳定。不稳定在于即使position指的是从0开始的item数,但依然要求在方法执行时该item是可见的,否则出bug。
我在线路详情遍历所有站点,采用这种方法,详细使用会在下文中说明。
3、搜索1-9
4、如果搜索结果返回多个匹配值,遍历所有匹配值。
由于不同搜索内容返回的结果是不同懂得,需要对搜索结果的处理,同时考虑网络环境不佳,导致无结果返回的情况。
for (String content : contents) {
performSearch(content);
Log.d("TestTab", "查询" + content);
Log.d("TestTab", "处理返回的结果");
if (solo.waitForActivity(LineDetailActivity.class, 2000)) {
Log.d("TestTab", "进入线路详情界面");
lineModule.run();
solo.goBack();
solo.goBack();
} else if (solo.waitForActivity(StationDetailActivity.class, 2000)) {
Log.d("TestTab", "进入车站详情界面");
stationModule.run();
solo.goBack();
solo.goBack();
} else if (solo.searchButton("重试", true)) {
Log.d("TestTab", "没有返回结果");
solo.goBack();
continue;
} else if (solo.searchText("没有找到合适的线路和车站", true)) {
Log.d("TestTab", "没有找到合适的线路和车站");
solo.goBack();
continue;
} else if (solo.waitForFragmentById(R.id.cll_fragment_fuzzy)) {
traversalResults();
solo.goBack();
}
}
这里主要是判断条件的应用。这里需要注意有两点,一是solo.waitForFragmentById()方法,在程序里如果ViewFlipper的机制是呈现的另个ViewGroup时,目标Fragment依然被初始化。那么solo.waitForFragmentById()就无法正常起作用。
二是searchXX方法。这个方法可以穿透封装,找到目标View。但是两个缺点:
- 由于方法内部是遍历所有View,寻找匹配项,耗时较长。
- 在ListView等组件中,该方法会自动滚动寻找匹配项,但不会再滚动回原来位置,在调用clickInLine等方法时,需要手动回滚到第一行。
traversalResults()方法,是通过上述第二种遍历ListView的方法遍历。
/**
* 遍历返回多个搜索结果的情况
*/
private void traversalResults() {
ListView lv = (ListView) solo.getView(R.id.cll_lv, 1);
solo.scrollListToTop(lv);
int sum = lv.getAdapter().getCount();
Log.d("TestTab", "有" + sum + "结果");
int itemCount = lv.getLastVisiblePosition() - lv.getFirstVisiblePosition() + 1;
Log.d("TestTab", "可见的Item有 " + itemCount);
int loops = sum / itemCount;
int last = sum % itemCount;
if (sum < itemCount + 1) {
for (int p = 1; p < sum + 1; p++) {
solo.clickInList(p);
toLineOrStation();
solo.goBack();
}
} else {
for (int i = 0; i < loops + 1; i++) {
if (i < loops) {
for (int m = 1; m < itemCount; m++) {//由于scrollDown()逻辑和遍历条件无关,到itemCount-1便停止遍历
solo.clickInList(m);
Log.d("TestTab", "搜索结果遍历" + m);
toLineOrStation();
solo.goBack();
}
solo.scrollDown();
} else {
for (int n = itemCount - last + 1; n < itemCount + 1; n++) {
solo.clickInList(n);
toLineOrStation();
solo.goBack();
}
}
}
}
}
需要得到三个值item的总数,单页可见Item数,前两者相除的余数,具体逻辑看上面代码。
注意在处理最后一页的逻辑。
最后一个需要注意的地方:
ListView lv = (ListView) solo.getView(R.id.cll_lv, 1);
Index为1,这是由于当时可以匹配到两个ListView,选择第二个。
5、如果进入站点详情,遍历所有路线,点击收藏按钮并取消收藏
两个步骤,遍历点击每个Item,遍历点击每个收藏按钮
遍历点击每个Item,获得Item总数,屏幕内item数量,前两者相除的商和余数,每次循环通过clickInLine遍历屏幕上的每一个item,循环商加一的次数,最后一次只需要遍历倒数余数个item。
@Override
public void run() {
solo.waitForActivity(StationDetailActivity.class);//保证recyclerView不为空。
RecyclerView recyclerView = (RecyclerView) solo.getView(R.id.cll_station_detail_list);
//找到目标RecyclerView,这样比getCurrentActivity().findViewById()更加有效。
LinearLayoutManager mLinearLayoutManager = (LinearLayoutManager) recyclerView.getLayoutManager();
int sum = recyclerView.getAdapter().getItemCount();
Log.d("TestTab", "共有 " + sum + " 条线路");
int itemCount = ((LinearLayoutManager) recyclerView.getLayoutManager()).findLastVisibleItemPosition() - ((LinearLayoutManager) recyclerView.getLayoutManager()).findFirstVisibleItemPosition() + 1;//计算显示在屏幕的item的数量
int loops = sum / itemCount;需要滚动几次
int last = sum % itemCount;最后一次
if (sum < itemCount + 1) {
for (int p = 0; p < sum; p++) {
clickItem(p);
clickFavourInStation(mLinearLayoutManager, p);
}
} else {
for (int i = 0; i < loops + 1; i++) {
if (i < loops) {
//保证不点击到返回按钮
recyclerView.smoothScrollToPosition(itemCount * i);//由于solo.scrollDown()不稳定,需要稳定的定位
for (int m = 0; m < itemCount; m++) {
clickItem(m);
clickFavourInStation(mLinearLayoutManager, i * itemCount + m);
}
solo.scrollDown();
} else {
int lastPageItemsCount = ((LinearLayoutManager) recyclerView.getLayoutManager()).findLastVisibleItemPosition() - ((LinearLayoutManager) recyclerView.getLayoutManager()).findFirstVisibleItemPosition() + 1;
for (int n = lastPageItemsCount - last, q = 0; n < lastPageItemsCount - 1; n++, q++) {
clickItem(n);
clickFavourInStation(mLinearLayoutManager, loops * itemCount + q);
}
}
}
}
}
点击收藏按钮并取消收藏:
主要思路是保证该Item可见的情况下,通过findViewByPosition找到目标Item的view,然后再找到处理监听事件的子View,click。
private void clickFavourInStation(LinearLayoutManager mLinearLayoutManager, int i) {
Log.d("TestTab", "点击收藏");
ViewGroup targetGroup = (ViewGroup) mLinearLayoutManager.findViewByPosition(i);
LineStnView mLineStnView = (LineStnView) targetGroup.getChildAt(1);
if (mLineStnView.getX() < 0) {
mLineStnView = (LineStnView) targetGroup.getChildAt(0);
}
View v = mLineStnView.findViewById(R.id.fav_view);
solo.clickOnView(v);
if (solo.waitForDialogToOpen()) {
solo.clickOnText("取消收藏");
} else {
solo.clickOnView(v);
solo.waitForDialogToOpen(2000);
solo.clickOnText("取消收藏");
}
}
6、如果进入线路详情,遍历所有站点,刷新,然后换向后,重复一遍换向前操作。
主要思路是:通过getView得到list组件,通过组件给定的方法使我们想要选中的目标Item保持在屏幕内,然后findViewByPosition找到目标Item的组件,依次点击。
这里设置一个Flag值用来记录是否已经变向。
private void traversalAllStat(Boolean flag) {
solo.waitForEmptyActivityStack(2000);
RealTimePanelContent content = (RealTimePanelContent) solo.getView(R.id.cll_real_time_panel_content);
Log.d("TestTab", "获取到RealTimePanelContent的实例");
LinearLayoutManager mLinearLayoutManager = (LinearLayoutManager) content.getLayoutManager();
Log.d("TestTab", "获取到LinearLayoutManager的实例");
int sum = content.getAdapter().getItemCount();//获取站数
Log.d("TestTab", "获取到车站数" + String.valueOf(sum - 1));
content.moveToPosition(3);
solo.waitForEmptyActivityStack(2000);
Log.d("TestTab", "等待2s到tab移动到左侧");
int lastPosition = mLinearLayoutManager.findLastVisibleItemPosition();
Log.d("TestTab", "界面出现的最后一个Item的position" + lastPosition);
for (int i = 0; i < sum - 1; i++) {
final ViewGroup viewGroup;
Log.d("TestTab", "当前position为 " + String.valueOf(i));
if (i < lastPosition) {
solo.waitForEmptyActivityStack(1000);
viewGroup = (ViewGroup) mLinearLayoutManager.findViewByPosition(i);
if ((!solo.waitForCondition(new myCondition(viewGroup), 3000)) || (!viewGroup.isShown())) {
Log.d("TestTab", "viewGroup为null");
content.moveToPosition(i);
Log.d("TestTab", "由于viewGroup为null,将" + i + "移动到中间");
i--;
Log.d("TestTab", "保持position位置不变");
continue;
}
Log.d("TestTab", "viewGroup不为null");
View viewToClick = viewGroup.findViewById(R.id.cll_apt_station_name);
if ((!viewToClick.isShown()) || (!solo.waitForView(viewToClick, 1500, true))) {
//这里反复验证取得View是否为空或者不可见,或者事件未触发
}
Log.d("TestTab", "viewToClick不可见");
content.moveToPosition(i);
Log.d("TestTab", "viewToClick不可见,将" + i + "移动到中间");
i--;
Log.d("TestTab", "保持position位置不变");
continue;
}
solo.clickOnView(viewToClick);
Log.d("TestTab", "点击到position" + String.valueOf(i));
if (!solo.waitForDialogToClose(6000)) {
Log.d("TestTab", "刷新框没有出现");
content.moveToPosition(i);
i--;
Log.d("TestTab", "保持position位置不变");
continue;
}
Log.d("TestTab", "点击收藏");
clickFavourInLine();
Log.d("TestTab", "点击刷新");
clickRefresh();
} else {
content.moveToPosition(lastPosition);
Log.d("TestTab", "将" + lastPosition + "移动到中间");
solo.waitForEmptyActivityStack(2000);
Log.d("TestTab", "等待2s");
lastPosition = mLinearLayoutManager.findLastVisibleItemPosition();
Log.d("TestTab", "改变lastPosition为" + lastPosition);
viewGroup = (ViewGroup) mLinearLayoutManager.findViewByPosition(i);
if ((!solo.waitForCondition(new myCondition(viewGroup), 3000)) || (!viewGroup.isShown())) {
Log.d("TestTab", "viewGroup为null");
content.moveToPosition(i);
Log.d("TestTab", "将" + i + "移动到中间");
i--;
Log.d("TestTab", "保持position位置不变");
continue;
}
View viewToClick = viewGroup.findViewById(R.id.cll_apt_station_name);
if (!viewToClick.isShown()) {
Log.d("TestTab", "viewToClick不可见");
content.moveToPosition(i);
Log.d("TestTab", "viewToClick不可见,将" + i + "移动到中间");
i--;
Log.d("TestTab", "保持position位置不变");
continue;
}
solo.clickOnView(viewToClick);
Log.d("TestTab", "点击到position" + String.valueOf(i));
if (!solo.waitForDialogToOpen(6000)) {
Log.d("TestTab", "刷新框没有出现");
content.moveToPosition(i);
i--;
Log.d("TestTab", "保持position位置不变");
continue;
}
Log.d("TestTab", "点击收藏");
clickFavourInLine();
Log.d("TestTab", "点击刷新");
clickRefresh();
}
if (i == sum - 2 && flag) {
flag = false;
Log.d("TestTab", "切换标志,不可再换向");
clickChangeDec();
Log.d("TestTab", "点击换向");
Log.d("TestTab", "重新遍历");
traversalAllStat(flag);
}
if (!solo.waitForDialogToClose(60000)) {
Log.d("TestTab", "刷新失败");
solo.goBack();
}
}
}
五、Caution
1、最稳定最常用的的solo.clickOnView(solo.getView(R.id.xxx));可封装成根据ID进行点击,优先使用。
2、时间控制
速度过慢不符合我们快速测试的需求
速度过快,会导致两个问题,一是前一个动作未响应完(动作本身耗时长或者网络环境不好),后一个动作触发找不到组件;二是并行冲突,比如listView前一动作要求listView向下滑,后一个动作要求向上滑。
解决方法:waitXX方法等待动作完成,如果在规定时间内没有完成
3、界面的作用范围