Robotium 自动化测试

原创 2015年08月19日 15:18:27

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、界面的作用范围

版权声明:本文为博主原创文章,未经博主允许不得转载。

Android 自动化测试工具Robotium 之Solo类的详细说明

package com.robotium.solo; import java.lang.reflect.Method; import java.util.ArrayList; import ...

Robotium_Robotium中solo的示例用法

示例代码一: public class EditorTest extends                 ActivityInstrumentationTestCase2EditorActivi...

Robotium版本更新日志翻译(不定期更新)

Android自动化测试工具Robotium当前已更新至5.5.4版本,以下整理了Robotium 5.0以后系列的更新日志,翻译可能存在错误,欢迎各位留言指出。 最新更新日期:2016.3.29 ...

Robotium API 翻译(四)——等待执行的方法sleep、waitFor

测试中经常出现明明有控件或者文本,但是由于界面没有载入完成或者其他原因导致assert判断的结果失败。或者两次执行,一次成功,一次失败的情况。所以需要加入这些等待某些控件或者文本载入的方法,以加强程序...

Robotium中文API(22)-solo.waitForDialogToClose

Robotium中文API(22)-solo.waitForDialogToClose waitForDialogToClose public boolean waitFo...

Robotium

本文内容:基于Android Studio 的Android自动化测试框架Robotium的开发 版权声明:本文为原创文章,未经允许不得转载 博客地址:http://blog.c...

robotium的一个测试尝试

这几天一直在学习robotium,但是在网上找了很久除了一个测试noteslist的例子外,其他基本上没有多少资料,但是网上关于noteslist的例子在我这不知道为什么老是行不同,于是就觉得自己弄,...
  • gzh0222
  • gzh0222
  • 2011年11月09日 15:09
  • 4170

robotium自动化测试简介

Robotium是一个测试框架,能够方便你为Android应用程序编写强大、健壮的自动化黑盒测试用例。利用Robotium的支持,用例开发人员能够编写功能、系统和验收测试方案,跨越多个 Android...

Android studio 下的Robotium自动化测试

一、前言 Android Studio 是一个Android开发环境,作为官方主推的开发环境和停止对其他开发IDE的支持,Android Studio将成为今后唯一的android开发环境。...

Robotium自动化测试框架实用教程(图)

一、简介 Robotium是一款国外的Android自动化测试框架,主要针对Android平台的应用进行黑盒自动化测试,它提供了模拟各种手势操作(点击、长按、滑动等)、查找和断言机制的API,能...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Robotium 自动化测试
举报原因:
原因补充:

(最多只允许输入30个字)