移动端测试——APP元素信息、事件操作、模拟手势API（4）

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()

更新中......

posted @ 2019-09-24 22:41 紫枫一梦千年阅读(586) 评论(0) 编辑收藏举报

刷新页面返回顶部

riscy
做技术一定要一颗恒心，这样才不会半途而废。

移动端测试——APP元素信息、事件操作、模拟手势API（4）

appium基础API

1.1 APP元素信息操作API

1.1.1 点击元素

1.1.2 发送数据到输入框

1.1.3 清空输入框内容

1.1.4 获取元素的文本内容

1.1.5 获取元素的属性值

1.1.6 获取元素在屏幕上的坐标

1.1.7 获取app包名和启动名

1.1.8 综合应用

1.2 APP元素事件操作API

1.2.1 swip滑动事件

1.2.2 scroll滑动事件

1.2.3 drag拖拽事件

1.2.4 应用置于后台事件

1.3 APP模拟手势高级操作

1.3.1 手指轻敲操作

1.3.2 手指按操作

1.3.3 等待操作

1.3.4 手指长按操作

1.3.5 模拟手机的滑动操作

公告

riscy做技术一定要一颗恒心，这样才不会半途而废。

移动端测试——APP元素信息、事件操作、模拟手势API（4）

appium基础API

1.1 APP元素信息操作API

1.1.1 点击元素

1.1.2 发送数据到输入框

1.1.3 清空输入框内容

1.1.4 获取元素的文本内容

1.1.5 获取元素的属性值

1.1.6 获取元素在屏幕上的坐标

1.1.7 获取app包名和启动名

1.1.8 综合应用

1.2 APP元素事件操作API

1.2.1 swip滑动事件

1.2.2 scroll滑动事件

1.2.3 drag拖拽事件

1.2.4 应用置于后台事件

1.3 APP模拟手势高级操作

1.3.1 手指轻敲操作

1.3.2 手指按操作

1.3.3 等待操作

1.3.4 手指长按操作

1.3.5 模拟手机的滑动操作

公告

riscy
做技术一定要一颗恒心，这样才不会半途而废。