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