在之前的控件搜索原理解析的文章中提到了,robotium在搜索控件时具有自动滚动的功能,接着就来了解一下其滚动是怎么实现的。滚动的功能实现在主要在Scroller.java中(吐槽一下,为什么Robotium的类名都起的清晰易懂,而代码里的变量名则经常文不对题呢??),主要入口是public boolean scroll(int direction, boolean allTheWay),里面会根据所需滚动的View类型——ListView, ScrollView以及WebView,分别采取三种不同的操作, 本文先了解一下ListView的滚动。
AbsListView的滚动
滚动原理很简单,直接利用view.setSelection(int positon)(不用担心会触发点击事件,查看ListView或GridView API文档的说明,其中有这样一句, If in touch mode, the item will not be selected but it will still be positioned appropriately. )
不过虽然结果很简单,但过程还是有些曲折的,接着看public <T extends AbsListView> boolean scrollList(T absListView, int direction, boolean allTheWay) 这个函数,以向下为例,跟踪一下滚动流程。
public <T extends AbsListView> boolean scrollList(T absListView, int direction, boolean allTheWay) {
if(absListView == null){
return false;
}
if (direction == DOWN) {
//向下滚动
if (allTheWay) {
//allTheWay表示直接滚到底
scrollListToLine(absListView, absListView.getCount()-1);
return false;
}
if (absListView.getLastVisiblePosition() >= absListView.getCount()-1) {
//列表已经处在底部
scrollListToLine(absListView, absListView.getLastVisiblePosition());
return false;
}
if(absListView.getFirstVisiblePosition() != absListView.getLastVisiblePosition())
//列表的显示宽度大于1
scrollListToLine(absListView, absListView.getLastVisiblePosition());
else
//列表的显示宽度等于1,则要滚动至FirstVisiblePosition()+1
scrollListToLine(absListView, absListView.getFirstVisiblePosition()+1);
} else if (direction == UP) {
if (allTheWay || absListView.getFirstVisiblePosition() < 2) {
//allTheWay或列表长度小于2,则直接滚到顶部
scrollListToLine(absListView, 0);
return false;
}
//计算列表的显示宽度
final int lines = absListView.getLastVisiblePosition() - absListView.getFirstVisiblePosition();
//根据宽度计算出该滚动至第几行
int lineToScrollTo = absListView.getFirstVisiblePosition() - lines;
if(lineToScrollTo == absListView.getLastVisiblePosition())
//当显示宽度为1时,向上回滚一行即可
lineToScrollTo--;
if(lineToScrollTo < 0)
//当上面的隐藏行数小于显示宽度时,直接滚动至第一行即可
lineToScrollTo = 0;
scrollListToLine(absListView, lineToScrollTo);
}
sleeper.sleep();
return true;
}
public <T extends AbsListView> void scrollListToLine(final T view, final int line){
if(view == null)
Assert.fail("AbsListView is null!");
final int lineToMoveTo;
if(view instanceof GridView)
//如果是GridView的话再+1
//当向下滚动时,如果只滚动至latsVisiblePositon,显然会重复显示一个元素,
//而且当postion > GridView.getCount - 1时,调用gridView.setSelection,gridView直接滚动到底部。
lineToMoveTo = line+1;
else
lineToMoveTo = line;
inst.runOnMainSync(new Runnable(){
public void run(){
//通过setSelection完成列表的自动滚动。
view.setSelection(lineToMoveTo);
}
});
对ListView比较了解的话,这里的代码应该很简单。不过有一个地方不明白,就是scrollListToLine对GridView的lineToMoveTo加了一。目前经过查看API文档和自己做得实验,找到+1的理由只有如下两点:
1) 当方向向下且列表显示宽度大于1时,加1可以避免lastVisiblePositon元素的重复显示
2) 当postion > view.size() – 1时,setSelection(postion) 会导致listView会滚动至顶部,而GridView会滚动至底部。
所以当滚动方向向下且列表宽度超过1时,此GridView的+1是能正常工作的。
不过,在如下情况下这个+1应该是会出错的:
1) 当方向向下且列表宽度为1时,此时在第一层searchFor时已经加了1,而scrollListToLine这里再给GridView加了1,那么如果原本的lastVisiblePosition为26的话,经过这样处理,会直接滚动到28,而27行就被直接跳过了(经过亲自验证,此时确实会出现问题)。
2) 方向向上时,这个+1就更加无厘头了,例如当用Solo.scrollToTop()时,gridView会滚到position = 1;更例如当列表宽度为1时,调用Solo.scrollUp(),你会发现gridView在原地踏步(两条都验证完毕)。
ScrollView的滚动
相对比AbsListView,ScrollView的滚动就简单多了,直接上代码
private boolean scrollScrollView(final ScrollView view, int direction){
if(view == null){
return false;
}
//获取控件高度
int height = view.getHeight();
//滚动量减一,为了容错性?
height--;
int scrollTo = -1;
//向下滚动,滚动量为正值
if (direction == DOWN) {
scrollTo = height;
}
//向下滚动,滚动量为负
else if (direction == UP) {
scrollTo = -height;
}
//记录当前控件处于滚动框顶部的位置
int originalY = view.getScrollY();
final int scrollAmount = scrollTo;
inst.runOnMainSync(new Runnable(){
public void run(){
//滚动
view.scrollBy(0, scrollAmount);
}
});
//对比滚动前后的位置,如果一样,说明已到达底部,返回false,否则返回true
if (originalY == view.getScrollY()) {
return false;
}
else{
return true;
}
}
WebView的滚动
更加简单,不多说了
public boolean scrollWebView(final WebView webView, int direction, final boolean allTheWay){
//滚动webView时,直接调用webView.pageDown()或
//webView.pageUp()
if (direction == DOWN) {
inst.runOnMainSync(new Runnable(){
public void run(){
canScroll = webView.pageDown(allTheWay);
}
});
}
if(direction == UP){
inst.runOnMainSync(new Runnable(){
public void run(){
canScroll = webView.pageUp(allTheWay);
}
});
}
return canScroll;
}