python开发App基础操作API使用示例过程 python开发App基础操作API使用示

手机控件查看工具uiautomatorviewer

工具简介
如何使用

APP元素定位操作

通过id定位
通过class定位
通过xpath定位
WebDriverWait 显示等待操作
发送数据到输入框
清空输入框内容：
获取元素的属性值
获取元素在屏幕上的坐标
获取app包名和启动名

APP元素事件操作API

swip滑动事件
scroll滑动事件
drag拖拽事件
应用置于后台事件

APP模拟手势高级操作

手指轻敲操作
手指按操作
等待操作
手指长按操作
手指移动操作

手机控件查看工具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)

【python开发App基础操作API使用示例过程】参数：
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='https://www.it610.com/article/name' 返回content-desc / text属性值value='https://www.it610.com/article/text' 返回text的属性值value='https://www.it610.com/article/className' 返回 class属性值，只有 API=>18 才能支持value='https://www.it610.com/article/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的辅助类，主要针对手势操作，比如滑动、长按、拖动等，
原理是将一系列的动作放在一个链条中发送到服务器，服务器接受到该链条后，解析各个动作，逐个执行
所有手势都要通过执行函数才会运行

手指轻敲操作
模拟手指轻敲一下屏幕操作