移动端测试——APP元素信息[事件]操作API和APP模拟手势高级操作
Posted ricsy
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了移动端测试——APP元素信息[事件]操作API和APP模拟手势高级操作相关的知识，希望对你有一定的参考价值。
appium基础API
1.1 APP元素信息操作API
介绍手机端元素信息的获取以及基本的输入操作
- 前置代码
# 导入driver对象
from appium import webdriver
import time
# server 启动参数
desired_caps =
# 设备信息（系统、版本、设备号）
desired_caps['platformName'] = 'android'
desired_caps['platformVersion'] = '9'
desired_caps['deviceName'] = '192.168.72.103:5555'
# app信息（包名、启动名）
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 声明driver对象
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
try:
pass
except Exception as e:
print(e)
finally:
# 关闭驱动对象
driver.quit()
1.1.1 点击元素
看前面的知识
1.1.2 发送数据到输入框
方法：value 需要发送到输入框内的文本
send_keys(vaue)
eg(业务场景):
打开设置,点击搜索框并输入内容abc
# 点击搜索框
driver.find_element_by_id("com.android.settings:id/search_action_bar").click()
# 定位到输入框并输入abc
driver.find_element_by_id("android:id/search_src_text").send_keys("abc")提示：
- 可以将输入的abc改成输入中文，得到的结果：
输入框无任何值输入且程序不会报错解决方法：
- server 启动参数增加两个参数配置
desired_caps[‘unicodeKeyboard‘] = True
desired_caps[‘resetKeyboard‘] = True
再次运行，会发现运行成功
# 点击搜索按钮
driver.find_element_by_id("com.android.settings:id/search_action_bar").click()
# 定位到输入框并输入abc
driver.find_element_by_id("android:id/search_src_text").send_keys("哈哈")1.1.3 清空输入框内容
方法：clear()
eg(业务场景):
打开设置,点击搜索框,输入内容abc,删除已输入abc
# 点击搜索按钮
driver.find_element_by_id("com.android.settings:id/search_action_bar").click()
# 定位到输入框并输入abc
input_text = driver.find_element_by_id("android:id/search_src_text")
# 输入abc
input_text.send_keys("abc")
time.sleep(1)
# 删除abc
input_text.clear()eg(业务场景):
打开设置,点击搜索框,多次输入内容，有下拉提示认为成功
driver.find_element_by_id("com.android.settings:id/search_action_bar").click()
for i in ("vp", "WLA", "ls"):
input_text = driver.find_element_by_id("android:id/search_src_text")
input_text.clear()
input_text.send_keys(i)
dropdown_data = driver.find_element_by_id("android:id/title").text
if dropdown_data:
print(True)
else:
print(False)
driver.find_element_by_class_name("android.widget.ImageButton").click()1.1.4 获取元素的文本内容
方法: text
eg(业务场景)：
进入设置，获取所有元素class属性为“android.widget.TextView”的文本内容
text_vlaue = driver.find_elements_by_class_name("android.widget.TextView")
for i in text_vlaue:
print(i.text)1.1.5 获取元素的属性值
方法: value:元素的属性
get_attribute(value)
| value | 说明 |
|---|---|
name |
返回text（优先）、content-desc属性值 |
text |
返回text的属性值 |
className |
返回 class属性值，只有 API=>18(4.3)才能支持 |
resourceId |
返回 resource-id属性值，只有 API=>18 (4.3)才能支持 |
eg(业务场景)：
进入设置，获取搜索框的content-desc属性值
# 定位到搜索框
get_value = driver.find_element_by_id("com.android.settings:id/search_action_bar")
print(get_value.get_attribute("name"))打开计算器，获取pi的各种属性
注意：
- 更改前置代码的启动应用的包名和启动名为计算器的
ele_pi = driver.find_element_by_id("com.android.calculator2:id/const_pi")
for i in ("name", "text", "className", "resourceId"):
print(ele_pi.get_attribute(i))
1.1.6 获取元素在屏幕上的坐标
方法:location
ge(业务场景)：
进入设置页面,获取搜索框在屏幕的坐标位置
# 定位到搜索框
get_value = driver.find_element_by_id("com.android.settings:id/search_action_bar")
# 打印搜索框在屏幕上的坐标
print(get_value.location)
1.1.7 获取app包名和启动名
获取包名方法：current_package
获取启动名：current_activity
eg(业务场景)：
启动设置，获取包名和启动名
print("包名：", driver.current_package)
print("启动名：", driver.current_activity)
1.1.8 综合应用
- 添加联系人
# 导入driver对象
from appium import webdriver
import time
import logging
# server 启动参数
desired_caps =
# 设备信息（系统、版本、设备号）
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '9'
desired_caps['deviceName'] = '192.168.72.103:5555'
# app信息（包名、启动名）
desired_caps['appPackage'] = 'com.android.contacts'
desired_caps['appActivity'] = '.activities.PeopleActivity'
# 声明driver对象
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
try:
# pass
driver.find_element_by_id("com.android.contacts:id/floating_action_button").click()
driver.find_element_by_id("com.android.contacts:id/left_button").click()
driver.find_element_by_xpath("//*[contains(@text,'姓氏')]").send_keys("张")
driver.find_element_by_xpath("//*[contains(@text,'名字')]").send_keys("小红")
driver.find_element_by_xpath("//*[contains(@text,'电话')]").send_keys("12345678910")
driver.find_element_by_class_name("android.widget.Button").click()
except Exception as e:
print(e)
finally:
# 关闭驱动对象
driver.quit()1.2 APP元素事件操作API
1.2.1 swip滑动事件
从一个坐标位置滑动到另一个坐标位置,只能是两个点之间的滑动
方法：
swipe(start_x, start_y, end_x, end_y, duration=None)
| 参数 | 说明 |
|---|---|
start_x |
起点X轴坐标 |
start_y |
起点Y轴坐标 |
end_x |
终点X轴坐标 |
end_y |
终点Y轴坐标 |
duration |
滑动这个操作一共持续的时间长度（单位：ms） |
eg(业务场景)：
进入设置,从坐标(148,659)滑动到坐标(148,248)
# 滑动没有持续时间
driver.swipe(148,659,148,248)
# 滑动持续5秒的时间
driver.swipe(148,659,148,248,5000)1.2.2 scroll滑动事件
从一个元素滑动到另一个元素，直到页面自动停止
方法：
scroll(origin_el, destination_el)
| 参数 | 说明 |
|---|---|
origin_el |
滑动开始的元素 |
destination_el |
滑动结束的元素 |
eg(业务场景)：
进入设置页，模拟手指从存储菜单位置 到 网络菜单位置的上滑操作
# 定位到存储菜单栏
el1 = driver.find_element_by_xpath("//*[contains(@text,'存储')]")
# 定位到网络菜单栏
el2 = driver.find_element_by_xpath("//*[contains(@text,'网络')]")
# 执行滑动操作
driver.scroll(el1,el2)1.2.3 drag拖拽事件
从一个元素滑动到另一个元素,第二个元素替代第一个元素原本屏幕上的位置
方法：
drag_and_drop(origin_el, destination_el)
| 参数 | 说明 |
|---|---|
origin_el |
滑动开始的元素 |
destination_el |
滑动结束的元素 |
eg(业务场景)：
进入设置页,模拟手指将存储菜单 滑动到网络菜单栏位置
# 定位到存储菜单栏
el1 = driver.find_element_by_xpath("//*[contains(@text,'存储')]")
# 定位到网络菜单栏
el2 = driver.find_element_by_xpath("//*[contains(@text,'网络')]")
# 执行滑动操作
driver.drag_and_drop(el1,el2)1.2.4 应用置于后台事件
APP放置后台，模拟热启动
方法：
background_app(seconds)
| 参数 | 名称 |
|---|---|
| seconds | 停留在后台的时间（单位：秒） |
eg(业务场景)：
进入设置页，将APP置于后台5s
driver.background_app(5)效果：
app置于后台5s后，再次展示当前页面
1.3 APP模拟手势高级操作
- TouchAction是AppiumDriver的辅助类，主要针对手势操作，比如滑动、长按、拖动等
- 原理是将一系列的动作放在一个链条中发送到服务器，服务器接受到该链条后，解析各个动作，逐个执行
- 所有手势都要通过执行函数才会运行
1.3.1 手指轻敲操作
模拟手指轻敲一下屏幕操作
方法：tap(element=None, x=None, y=None)
参数|说明
-|-
element|被定位到的元素
x|相对于元素左上角的坐标，通常会使用元素的X轴坐标
y|通常会使用元素的Y轴坐标
方法：发送命令到服务器执行操作
perform()
eg(业务场景)：
进入设置，点击WLAN选项
el = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]")
# 通过元素定位方式敲击屏幕
TouchAction(driver).tap(el).perform()
# 通过坐标方式敲击屏幕，WLAN坐标:x=155,y=250
TouchAction(driver).tap(x=155,y=250).perform()1.3.2 手指按操作
模拟手指按下屏幕,按就要对应着离开
方法:press(el=None, x=None, y=None)
参数|说明
-|-
element|被定位到的元素
x|通常会使用元素的X轴坐标
y|通常会使用元素的Y轴坐标
方法：结束动作，手指离开屏幕
release()
eg(业务场景):
进入设置，点击WLAN选项
el = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]")
# 通过元素定位方式按下屏幕
TouchAction(driver).press(el).release().perform()
# 通过坐标方式按下屏幕，WLAN坐标:x=155,y=250
# TouchAction(driver).tap(x=155,y=250).release().perform()1.3.3 等待操作
方法：wait(ms=0)
参数：ms 暂停的毫秒数
eg(业务场景):
进入设置，点击WLAN选项，长按WiredSSID选项5秒
# 点击WLAN
driver.find_element_by_xpath("//*[contains(@text,'WLAN')]").click()
# 定位到WiredSSID
el =driver.find_element_by_id("android:id/title")
# 通过元素定位方式长按元素
TouchAction(driver).press(el).wait(5000).perform()
# 该方法未能完成长按操作，没有报任何错误
# TouchAction(driver).press(x=171,y=245).wait(5000).release().perform() 1.3.4 手指长按操作
模拟手机按下屏幕一段时间,按就要对应着离开.
方法：
long_press(el=None, x=None, y=None, duration=1000)
| 参数 | 说明 |
|---|---|
element |
被定位到的元素 |
x |
通常会使用元素的X轴坐标 |
y |
通常会使用元素的Y轴坐标 |
duration |
持续时间，默认为1000ms |
eg(业务场景):
进入设置，点击WLAN选项，长按WiredSSID选项5秒
# 点击WLAN
driver.find_element_by_xpath("//*[contains(@text,'WLAN')]").click()
# 定位到WiredSSID
el =driver.find_element_by_id("android:id/title")
# 通过元素定位方式长按元素
TouchAction(driver).long_press(el,duration=5000).release().perform()
# 通过坐标方式长按元素，WLAN坐标:x=161,y=242
# 通过这个方法定位时报服务端错误，怀疑是appium1.7.1版本bug
# TouchAction(driver).long_press(x=161,y=242).perform() 1.3.5 模拟手机的滑动操作
方法：
move_to(el=None, x=None, y=None)
| 参数 | 说明 |
|---|---|
el |
定位的元素 |
x |
相对于前一个元素的X轴偏移量 |
y |
相对于前一个元素的Y轴偏移量 |
eg(业务场景1)：
进入设置,向上滑动屏幕
# 定位到存储
el = driver.find_element_by_xpath("//*[contains(@text,'存储')]")
# 定位到更多
el1 = driver.find_element_by_xpath("//*[contains(@text,'更多')]")
# 元素方式滑动
TouchAction(driver).press(el).move_to(el1).release().perform()
# 坐标的方式滑动
# TouchAction(driver).press(x=240,y=600).wait(100).move_to(x=100,y=100).release().perform()eg(业务场景2)：
进入设置，向上滑动屏幕到可见"安全"选项，进入到安全，点击屏幕锁定方式，点击图案，绘制图案
# 定位到WLAN
el1 = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]")
# 定位到存储
el2 = driver.find_element_by_xpath("//*[contains(@text,'存储')]")
# 存储上滑到WLAN
driver.drag_and_drop(el2,el1)
# 定位到用户
el3 = driver.find_element_by_xpath("//*[contains(@text,'用户')]")
# 注意 这次使用drag_and_drop方法，传入的"存储定位"仍使用其原始在屏幕上的位置，所以是由存储滑动到用户才可以上滑，否则需要重新"定位存储"
# 存储上滑倒用户位置
driver.drag_and_drop(el2,el3)
# 点击安全按钮
driver.find_element_by_xpath("//*[contains(@text,'安全')]").click()
# 点击屏幕锁定方式按钮
driver.find_element_by_xpath("//*[contains(@text,'屏幕锁定')]").click()
# 点击图案按钮
# 绘制图案四个坐标 1:(80,256) 2:(240,256) 3:(240,418) 4:(400,418)
TouchAction(driver).press(x=80,y=256).wait(100).move_to(x=160,y=0).wait(100).move_to(x=0,y=162).wait(100).move_to(x=160,y=0).release().perform()更新中......
以上是关于移动端测试——APP元素信息[事件]操作API和APP模拟手势高级操作的主要内容，如果未能解决你的问题，请参考以下文章