八、UiScrollable API 详细介绍

最新推荐文章于 2024-07-22 13:44:18 发布
最新推荐文章于 2024-07-22 13:44:18 发布
阅读量898 收藏
点赞数
分类专栏： 移动自动化测试

Tip：

1.扫动过程中如果界面停留在滚动条的中间部分会先回到起点再进行滚动
2.扫动过程中设置的步长长短决定划过内容的多少，步长越长滑过的内容就越少；步长越短划过的内容就越长

一、UiScrollable 类介绍

1.UiScrollable类说明

1）UiScrollable是UiCollection的子类，可以使用UiBoject和UiCollection的所有API
2）UiScrollable是专门处理滚动时间的类，提供各种滚动方法

二、快速滚动

1.滚动相关概念

1）步长：步长越长，滑动越慢
2）扫动：也就是滑动，扫动几次就是滑动几次

2.快速滚动相关API

返回值

API

说明

booleanflingBackward()以步长为5(默认值)快速向上(后)滑动
booleanflingForward()以步长为5(默认值)快速向下(前)滑动
booleanflingToBeginning(int maxSwipes)自定义扫动次数以步长为5(默认值)快速滑动到开始
booleanflingTuEnd(int maxSwipes)自定义扫动次数以步长为5(默认值)快速滑动到结束

 

  • 例如：
复制代码 
public void testDemo1() throws UiObjectNotFoundException{

    UiScrollable scroll=new UiScrollable(new UiSelector().className("android.widget.ListView"));
    //以步长为5(默认值)快速向下(前)滑动
    scroll.flingForward();
    sleep(1000);
    //以步长为5(默认值)快速向上(后)滑动
    scroll.flingBackward();
    sleep(1000);
    //自定义扫动次数(5)以步长为5(默认值)快速滑动到结束
    scroll.flingToEnd(5);
    sleep(1000);
    //自定义扫动次数(4)以步长为5(默认值)快速滑动到开始
    scroll.flingToBeginning(4);
    sleep(1000);

}
复制代码

 

 

三、获取列表子元素

返回值

API

说明

UiObjectgetChildByDescription(UiSelector childPattern,String text,boolean allowScrollSearch)是否允许滚动查找获取具备UiSelector条件元素集合后再以文本描述条件查找对象
UiObjectgetChildByDescription(UiSelector childOattern,String text)默认获取具备UiSelector条件的元素集合后再以文本描述条件查找对象
UiObjectgetChildByInstance(UiSelector childPattern,int instance)获取具备UiSelector条件的子集，再从子集中按照实例筛选想要的元素（不滚动）
UiObjectgetChildByText(UiSelector childPattern,String text,boolean allowScrollSearch)是否允许滚动获取具备UiSelector条件的元素集合后再以文本条件查查找对象
UiObjectgetChildByText(UiSelector childPattern,String text)默认滚动获取具备UiSelector条件元素集合后再以文本条件的查找对象

 

  • 例如：
复制代码 
public void testDemo2() throws UiObjectNotFoundException{

    //getChildByText()
    //1.找到集合
    UiScrollable scroll=new UiScrollable(new UiSelector().className("android.widget.ListView"));
    //2.使用默认滚动获取并点击对象(class.text定位)
    UiObject Jian1016=scroll.getChildByText(new UiSelector().className("android.view.View"), "Jian1016");
    Jian1016.click();
    UiDevice.getInstance().pressBack();
    //3.允许滚动获取并点击对象(class.text定位)
    UiObject Jian1017=scroll.getChildByText(new UiSelector().className("android.view.View"), "Jian1017",true);
    Jian1017.click();
    UiDevice.getInstance().pressBack();
    //4.不允许滚动获取并点击对象(class.text定位);当不允许滚动查找对象的时候若当前界面没有则报错
    UiObject Jian1020=scroll.getChildByText(new UiSelector().className("android.view.View"), "Jian1020",false);
    Jian1020.click();



    //getChildByInstance()
    //需要注意的是他没有滚动查找选项，他只会按照当前界面显示instance位置情况进行查找，如果超出当前界面instance数量则报错
    UiObject Jian1=scroll.getChildByInstance(new UiSelector().className("android.view.View"), 1);
    Jian1.click();
}
复制代码

 

 

四、获取与设置最大滚动次数常量值

返回值

API

说明

intgetMaxSearchSwipes()获取执行搜索滑动过程中的最大滑动次数，默认常量为30 (若30次找不到则报错)
UiScrollablesetMaxSearchSwipes(int swipes)设置最大可扫动次数(超出设置次数还未搜索到则报错)

 

  • 例如：
复制代码 
public void testDemo3() throws UiObjectNotFoundException{

    //getMaxSearchSwipes()
    //1.找到联系人列表集合
    UiScrollable scroll=new UiScrollable(new UiSelector().className("android.widget.ListView"));
    //2.找到以text为条件进行查找
    UiObject text=new UiObject(new UiSelector().text("Jian1001"));
    //3.滚动并查找textview(默认滚动30次)
    scroll.scrollIntoView(text);
    //5.点击
    text.click();
    //6.输出getMaxSearchSwipes()的默认滚动次数
    System.out.println(scroll.getMaxSearchSwipes());



    //setMaxSearchSwipes(int swipes)
    //1.找到联系人列表集合
    UiScrollable scroll1=new UiScrollable(new UiSelector().className("android.widget.ListView"));
    //2.找到以text为条件进行查找
    UiObject text1=new UiObject(new UiSelector().text("Jian1001"));
    //3.设置最大滚动次数为3
    scroll1.setMaxSearchSwipes(3);
    //4.滚动并查找对象
    scroll1.scrollIntoView(text1);
    //5.点击
    text1.click();

}
复制代码

 

 

五、滑动区域校准常量设置与获取

1.校准概念
  • 校准常量指滑动操作坐标时候的偏移量，用来取偏移比例
2.相关API

返回值

API

说明

doublegetSwipeDeadZonePercentage()默认常量值为0.1也就是10%区域不滑动
UiScrollablesetSwieDeadZonePercentage(double swipeDeadZonePercentage)设置一个不见的大小，在滑动时，视为无接触区的百分比(也就是不滑动区域的百分比)

 

  • 例如：
复制代码 
public void testDemo4() throws UiObjectNotFoundException{

    //1.找到联系人列表集合
    UiScrollable scroll=new UiScrollable(new UiSelector().className("android.widget.ListView"));
    //2.声明变量dead
    double dead=scroll.getSwipeDeadZonePercentage();
    //3.输出变量默认值(getSwipeDeadZonePercentage()的默认值)
    System.out.println(dead);
    //4.自定义(不滑动区域为20%)(setSwipeDeadZonePercentage())
    scroll.setSwipeDeadZonePercentage(0.2); //如果加到0.5(50%)则不进行滑动变成点击操作了 
    //5.进行滑动操作
    scroll.scrollForward();

}
复制代码

 

 

六、向前与向后滚动

返回值

API

说明

booleanscrollBackward(int steps)自定义步长向后(上)滚动
booleanscrollBackward()以默认步长55向后(上)滚动
booleanscrollForward()以默认步长55向前(下)滚动
booleanscrollForward(int steps)自定义步长向前(下)滚动

 

  • 例如：
复制代码 
public void testDemo5() throws UiObjectNotFoundException{
    //1.找到联系人列表集合
    UiScrollable scroll=new UiScrollable(new UiSelector().className("android.widget.ListView"));
    scroll.scrollForward();//默认向前(下)滚动
    scroll.scrollForward(20);//自定义步长(20)向前(下)滚动
    scroll.scrollBackward();//默认向后(上)滚动
    scroll.scrollBackward(20);//自定义步长(20)向后(上)滚动
}
复制代码

 

 

七、滚动到某个对象

1.相关API

返回值

API

说明

booleanscrollIntoView(UiSelector selector)滚动到条件元素所在位置，并且尽量让其居于屏幕中央
booleanscrollIntoView(UiObject obj)滚动到对象所在位置，并且尽量让其居于屏幕中央
booleanscrollTextIntoView(String text)滚动到文本对象所在位置，并且尽量让其居于屏幕中央
booleanscrollDescriptionIntoView(String text)滚动到描述所在位置，并且尽量让其居于屏幕中央
booleanscrollToBeginning(int maxSwipes)自定义扫动次数滚动到开始位置(使用默认步长)
booleanscrollToBeginning(int maxSwipes,int steps)自定义扫动次数与步长滚动到开始位置
booleanscrollToEnd(int maxSwipes,int steps)自定义扫动次数与步长滚动到结束位置
booleanscrollToEnd(int maxSwipes)自定义扫动次数滚动到结束位置(使用默认步长)

 

  • 例如：
复制代码 
public void testDemo6() throws UiObjectNotFoundException{

    //scrollIntoView(UiSelector selector)
    //1.找到联系人列表集合
    UiScrollable scroll=new UiScrollable(new UiSelector().className("android.widget.ListView"));
    //2.使用UiSelector条件定位对象
    UiSelector selector=new UiSelector().text("Jian1015");
    //3.滚动操作
    scroll.scrollIntoView(selector);


    //scrollIntoView(UiObject obj)
    //1.找到联系人列表集合
    UiScrollable scroll1=new UiScrollable(new UiSelector().className("android.widget.ListView"));
    //2.使用UiObject条件定位对象
    UiObject obj=new UiObject(new UiSelector().text("Jian1100"));
    //3.滚动操作
    scroll1.scrollIntoView(obj);


    //scrollTextIntoView(String text)   
    //1.找到联系人列表集合
    UiScrollable scroll2=new UiScrollable(new UiSelector().className("android.widget.ListView"));
    //2.通过文本进行滚动查找操作
    scroll2.scrollTextIntoView("Jian1100");


    //scrollDescriptionIntoView(String text)
    //1.找到联系人列表集合
    UiScrollable scroll3=new UiScrollable(new UiSelector().className("android.widget.ListView"));
    //2.通过描述进行滚动查找操作
    scroll3.scrollDescriptionIntoView("Jian1011的快速联系人照片");


    //1.找到联系人列表集合
    UiScrollable scroll4=new UiScrollable(new UiSelector().className("android.widget.ListView"));
    //2.自定义扫动次数滚动到开始位置(使用默认步长)
    scroll4.scrollToBeginning(5);
    //3.自定义扫动次数滚动到结束位置(使用默认步长)
    scroll4.scrollToEnd(5);
    //4.自定义扫动次数与步长滚动到开始位置
    scroll4.scrollToBeginning(5, 10);
    //5.自定义扫动次数与步长滚动到结束位置
    scroll4.scrollToEnd(5, 10);
}
复制代码

 

 

八、设置滚动方向

1.相关API

返回值

API

说明

UiScrollablesetAsHorizontalList()设置滚动方向，设置为水平滚动
UiScrollablesetAsVerticalList()设置滚动方向，设置为纵向滚动

 

  • 例如：
复制代码 
public void testDemo7() throws UiObjectNotFoundException{

    //1.找到联系人列表集合(与前面滚动例子中的className不同)
    UiScrollable scroll4=new UiScrollable(new UiSelector().className("android.widget.FrameLayout"));
    //2.设置为水平滚动
    scroll4.setAsHorizontalList();
    //3.前(右)后(左)各滚动一次
    scroll4.scrollForward();
    sleep(2000);
    scroll4.scrollBackward();
    sleep(2000);
    //4.设置为纵向滚动
    scroll4.setAsVerticalList();
    //5.前后各滚动一次
    scroll4.scrollForward();
    sleep(2000);
    scroll4.scrollBackward();
    sleep(2000);

}

maocaowu_001
关注
专栏目录
UiAutomator笔记之UiScrollable API（六）
yiwaChen的博客
11-27 4706
一、UiScrollable简介 1、UiScrollable是UiCollection的子类。 2、UiScrollable专门处理滚动时间，提供各种滚动方法。 常用功能有：向前滚动、向后滚动、快速滚动、滚动到某个对象、设置滚动方向、设置滚动次数等。   二、API详细介绍 1、快速滚动 （1）相关概念 步长：从一点到另一点使用的时间。步长越短滚动越快，反之步长越长滚动越慢。
Android自动化测试UIautomator-UiScrollable
04-04
Android自动化测试UIautomator-UiScrollable api介绍
Android 自动化测试经验 - UiScrollable
01-24 140
UiScrollable is aUiCollectionand provides support for searching for items in a scrollable user interface (UI) elements. This class can be used with horizontally or vertically scrollable control...
HarmonyOS Next开发学习手册——Web组件嵌套滚动
最新发布
maniuT的博客
07-22 886
Web组件嵌套滚动的典型应用场景为，在一个页面中，有多个独立的区域需要进行滚动，当用户滚动Web区域内容时，可带动其他滚动区域进行滚动，以达到上下滑动页面的用户体验。内嵌在可滚动容器（ Scroll 、 List …）中的Web组件，接收到滑动手势事件，需要对接ArkUI框架的 NestedScrollMode 枚举类型，使得Web组件可以嵌套ArkUI可滚动容器，进行嵌套滚动。
UiAutomator之UiCollection UiScrollable UiWatcher
huanyi0723的专栏
06-26 6806
直接吧API全部分析完算了
UiScrollableAPI
a1003434346的博客
01-28 466
一、UiScrollable介绍 UiScrollable专门处理滚动事件，提供各种滚动方法 UiScrollable是UiCollection的子类 二、API使用 快速滚动API flingBackward():以步长为5快速向后滑动 flingForward():以步长为5快速向前滑动 flingToBeginning(int maxSwipes):自定义扫动次数以步长为5快速...
Android 自动化测试经验分享 深入UiScrollable
01-20
对于初学者，推荐进一步学习UI Automator官方文档，了解其完整的API和用法，以及如何与其他测试框架集成。同时，熟悉UiObject和UiSelector的使用也是提升自动化测试效率的关键。实践中，通过编写测试用例并不断调试...
Android UIautomator高级技巧：实现UiScrollable对象的智能滚动查找
UiScrollable是Android UIAutomator API的一部分，用于与具有滚动功能的UI组件进行交互，以便自动化测试能够遍历或定位那些隐藏在滚动视图中的元素。 首先，我们来看一下如何创建一个UiScrollable对象。创建一个新...
Android uiautomator自动化API简介
06-05
本文主要介绍Android uiautomator的主要API，并结合实例和具体介绍。 一、Uiautomator API Uiautomator API是在uiautomator.jar文件中，主要包括UiDevice、UiSelector、UiObject、UiCollection、UiScrollable等几...
Android基于uiautomator测试(七) --UiScrollable使用
DLUT_WJX的博客
05-26 1744
UiScrollable类是UiCollection的子类 UiScrollable是UiCollection的子类 UiScrollable专门处理滚动事件，提供各种滚动方法 滚动方法 向前滚动 向后滚动 快速滚动 滚动到某个对象 设置滚动方向 设置滚动次数 滚动的相关概念： 步长：从一个点滑到另一个点所用的时间 扫动次数：滚动一个列表，划到某...
Android UiAutomator UiScrollable类
shfscut的博客
04-27 1310
讲解了Android UiAutomator UiScrollable类，并附上实例
UiAutomator（5）--UiScrollable API
七天不过夜的专栏
11-03 753
UiAutomator（5）--UiScrollable API 一、UiScrollable介绍    1.UiScrollable是UiCollection的子类    2.UiScrollable专门处理滚动事件，提供各种滚动方法 二、API使用    1.快速滚动API      （1）flingBackward():以步长为5快速向后滑动      （2）fling
UIScrollable的基本讲解
bruscar的专栏
10-29 1675
UiScrollable:可滚动的控件，如果操作的控件需要滚动就可以使用UiScrollable     如：UiScrollable  appsList=new UiScrollable(new UiSelector().className("android.view.View"));     appsList.setAsHorizontalList(); 快速滚动 、获取列表子元素、
关于滚动的属性和api整理
张印的博客
04-09 198
容器元素 element.scrollTop/scrollLeft // 获取或设置一个元素的内容垂直滚动的像素数（可读可写） element.clientHeight // 如下图（只读） element.scrollHeight // 获取一个元素内容高度的度量，包括由于溢出导致的视图中不可见内容（只读） element.scrollTo(x-coord, y-coord); // 使内容滚动到给定元素的指定坐标位置 element.scrollBy(x-coord, y-coord)
Python GUI编程入门(35)-生成带有滚动功能控件的scrollable函数
面向对象思考
10-30 1019
当程序达到一定规模后，经常会希望构建带滚动功能的控件。例如下图中的FileBrowser，无论是左侧的TreeView还是右侧的ListView都带有水平和垂直两个Scrollbar控件。 Tkinter中生成带有Scrollbar的控件的代码大致如下： #生成Frame容器以容纳TreeView,Scrollbartree_area = Frame(paned_wind...
python+appium自动化测试-滑动到固定的位置停止
公众号已改名为-程序员阿沐
04-13 1118
python+appium自动化测试-滑动到固定的位置停止
UI自动化python中appium元素定位操作笔记滑动2
weixin_68440128的博客
06-01 611
习题1：在首页搜索框中输入“小米手机”，点击搜索按钮 点击搜索到的第一个商品，进入商品详情页 点击“加入购物车”，购买数量为2件，并确定 暂停5秒，关闭驱动 要求：设置隐式等待10秒 习题2：点击“我的”进入我的页面，点击用户头像进入登录页面 输入账号、密码，同意协议，点击登录按钮 登录成功之后，获取当前用户的昵称并打印 暂停5秒，关闭驱动 要求：设置隐式等待10秒 习题3：点击“我的”进入我的页面 暂停2秒，向上滑动一次屏幕 点击"地址管理"进入地址管理页面 暂停5秒，关闭驱动 要求：设置隐式等待
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值