手机控件查看工具uiautomatorviewer
工具简介
用来扫描和分析Android应用程序的UI控件的工具.
如何使用
1.进入SDK目录下的tools目录,打开uiautomatorviewer
2.电脑连接真机或打开android模拟器
3.启动待测试app
4.点击uiautomatorviewer的左上角Device Screenshot,会生成app当前页面的UI控件截图
5.选择截图上需要查看的控件,即可浏览该控件的id,class,text,坐标等信息
APP元素定位操作
Appium常用元素定位方式
前置代码
from appium import webdriver
# server 启动参数
desired_caps = {}
# 设备信息
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# app的信息
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 声明我们的driver对象
driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps)
通过id定位
方法:find_element_by_id(id_value) # id_value:为元素的id属性值
业务场景:
1.进入设置页面
2.通过ID定位方式点击搜索按钮
通过class定位
方法:find_element_by_class_name(class_value) # class_value:为元素的class属性值
业务场景:
1.进入设置页面
2.通过搜索按钮
3.通过class定位方式点击输入框的返回按钮
通过xpath定位
方法:find_element_by_xpath(xpath_value) # xpath_value:为可以定位到元素的xpath语句
*** android端xptah常用属性定位:
1. id ://*[contains(@resource-id,'com.android.settings:id/search')]
2. class ://*[contains(@class,'android.widget.ImageButton')]
3. text ://*[contains(@text,'WLAN')]
*** 模糊定位 contains(@key,value): value可以是部分值
业务场景:
1.进入设置页面
2.点击WLAN菜单栏
定位一组元素,注意element -> elements
应用场景为元素值重复,无法通过元素属性直接定位到某个元素,只能通过elements方式来选择,返回一个定位对象的列表.
WebDriverWait 显示等待操作
在一个超时时间范围内,每隔一段时间去搜索一次元素是否存在,
如果存在返回定位对象,如果不存在直到超时时间到达,报超时异常错误。
方法:WebDriverWait(driver, timeout, poll_frequency).until(method)
参数:
driver
:手机驱动对象
timeout
:搜索超时时间
poll_frequency
:每次搜索间隔时间,默认时间为0.5s
method
:定位方法(匿名函数)
使用示例:
WebDriverWait(driver, timeout, poll_frequency).until(lambda x: x.find_elements_by_id(id_value))
解释:
1.x传入值为:driver,所以才可以使用定位方法.
函数运行过程:
1.实例化WebDriverWait类,传入driver对象,之后driver对象被赋值给WebDriverWait的一个类变量:self._driver
2.until为WebDriverWait类的方法,until传入method方法(即匿名函数),之后method方法会被传入self._driver
3.搜索到元素后until返回定位对象,没有搜索到函数until返回超时异常错误.
业务场景:
1.进入设置页面
2.通过ID定位方式点击搜索按钮
发送数据到输入框
方法:send_keys(vaue) # value:需要发送到输入框内的文本
业务场景:
1.进入设置页面
2.点击搜索按钮
3.输入内容abc
解决输入中文问题:
server
启动参数增加两个参数配置
desired_caps['unicodeKeyboard'] = True
desired_caps['resetKeyboard'] = True
清空输入框内容:
方法:clear()
获取元素的属性值
方法: get_attribute(value) # value:元素的属性
业务场景:
1.进入设置页面
2.获取搜索按钮的content-desc属性值
value='name' 返回content-desc / text属性值
value='text' 返回text的属性值
value='className' 返回 class属性值,只有 API=>18 才能支持
value='resourceId' 返回 resource-id属性值,只有 API=>18 才能支持
获取元素在屏幕上的坐标
方法:location
获取app包名和启动名
获取包名方法:current_package
获取启动名:current_activity
APP元素事件操作API
swip滑动事件
从一个坐标位置滑动到另一个坐标位置,只能是两个点之间的滑动
方法:swipe(start_x, start_y, end_x, end_y, duration=None)
参数:
1.start_x
:起点X轴坐标
2.start_y
:起点Y轴坐标
3.end_x
: 终点X轴坐标
4.end_y
: 终点Y轴坐标
5.duration
: 滑动这个操作一共持续的时间长度,单位:ms
业务场景:
1.进入设置页面
2.从坐标(148,659)滑动到(148,248)
scroll滑动事件
从一个元素滑动到另一个元素,直到页面自动停止
方法:scroll(origin_el, destination_el)
参数:
1.origin_el
:滑动开始的元素
2.destination_el
:滑动结束的元素
业务场景:
1.进入设置页面
2.从存储菜单位置滑动到WLAN菜单位置
drag拖拽事件
从一个元素滑动到另一个元素,第二个元素替代第一个元素原本屏幕上的位置
方法:drag_and_drop(origin_el, destination_el)
参数:
1.origin_el
:滑动开始的元素
2.destination_el
:滑动结束的元素
应用置于后台事件
APP放置后台,模拟热启动
方法:background_app(seconds)
参数:
1.seconds
:停留在后台的时间,单位:秒
APP模拟手势高级操作
TouchAction是AppiumDriver的辅助类,主要针对手势操作,比如滑动、长按、拖动等,
原理是将一系列的动作放在一个链条中发送到服务器,服务器接受到该链条后,解析各个动作,逐个执行
所有手势都要通过执行函数才会运行
手指轻敲操作
模拟手指轻敲一下屏幕操作
方法:tap(element=None, x=None, y=None)
方法:perform() # 发送命令到服务器执行操作
参数:
1.element
:被定位到的元素
2.x
:相对于元素左上角的坐标,通常会使用元素的X轴坐标
3.y
:通常会使用元素的Y轴坐标
业务场景:
1.进入设置页面
2.点击WLAN选项
手指按操作
模拟手指按下屏幕,按就要对应着离开.
方法:press(el=None, x=None, y=None)
方法:release() # 结束动作,手指离开屏幕
参数:
1.element:被定位到的元素
2.x:通常会使用元素的X轴坐标
3.y:通常会使用元素的Y轴坐标
等待操作
方法:wait(ms=0)
参数:
ms:暂停的毫秒数
业务场景:
1.进入设置页面
2.点击WLAN选项
3.长按选项5秒
手指长按操作
模拟手机按下屏幕一段时间,按就要对应着离开.
方法:long_press(el=None, x=None, y=None, duration=1000)
参数:
1.element:被定位到的元素
2.x:通常会使用元素的X轴坐标
3.y:通常会使用元素的Y轴坐标
4.duration:持续时间,默认为1000ms
手指移动操作
模拟手机的滑动操作
方法:move_to(el=None, x=None, y=None)
参数:
1.el:定位的元素
2.x:相对于前一个元素的X轴偏移量
3.y:相对于前一个元素的Y轴偏移量
业务场景:
1.进入设置页面
2.向上滑动屏幕
练习:
业务场景:
1.进入设置页面
2.向上滑动屏幕到可见“安全”选项
3.进入到安全
4.点击屏幕锁定方式
5.点击图案
6.绘制图案
以上就是python开发App基础操作API使用示例过程的详细内容,更多关于python开发App基础操作API的资料请关注编程网其它相关文章!