本文详细介绍了使用Appium进行自动化测试时的元素定位操作，包括通过id、class和xpath，以及使用WebDriverWait进行显示等待。同时，讲解了获取元素信息、输入操作、事件操作API，如滑动、拖拽、手势操作，以及手机操作API，如获取时间、网络状态、截图等，提供了一系列的代码实现示例。
前置代码：
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'
# 中文处理
desired_caps['unicodeKeyboard'] = True
desired_caps['resetKeyboard'] = True
# 声明driver对象
driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps)
一、APP元素定位操作（id，class，xpath）
1 通过 id 定位，定位一组时为 elements
方法：find_element(s)_by_id(id_value) # id_value:为元素的id属性值
定位单个元素:
driver.find_element_by_id("com.android.settings:id/search").click()
定位一组元素:
title = driver.find_elements_by_id("com.android.settings:id/title") # title为列表
titile[0].click()
2 通过 class 定位，定位一组时为 elements
方法：find_element(s)_by_class_name(class_value) # class_value:为元素的class属性值
定位单个元素:
driver.find_element_by_class_name('android.widget.ImageButton').click()
定位一组元素:
title = driver.find_elements_by_class_name("android.widget.TextView")
title[0].click
3 通过 xpath 定位，定位一组时为 elements
方法：find_element(s)_by_xpath(xpath_value) # xpath_value:为定位到元素的xpath语句
定位单个元素:
driver.find_element_by_xpath("//*[contains(@text,'WLA')]").click()
定位一组元素:
title = driver.find_elements_by_xpath("//*[contains(@class,'widget.TextView')]")
title[0].click
android端xptah常用属性定位：
1. id ://*[contains(@resource-id,'com.android.settings:id/search')]
2. class ://*[contains(@class,'android.widget.ImageButton')]
3. text ://*[contains(@text,'WLA')]，模糊定位 contains(@key,value): value可以是部分值
4 WebDriverWait 显示等待操作
方法：WebDriverWait(driver, timeout, poll_frequency).until(method)
参数：
1.driver：手机驱动对象
2.timeout：搜索超时时间
3.poll_frequency：每次搜索间隔时间，默认时间为0.5s
4.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返回超时异常错误.
代码实现：
# 导入WebDriverWait类
from selenium.webdriver.support.wait import WebDriverWait
# 超时时间为30s，每隔1秒搜索一次元素是否存在，如果元素存在返回定位对象并退出
search_button = WebDriverWait(driver, 30, 1).until(lambda x: x.find_elements_by_id(com.android.settings:id/search))
search_button.click()
driver.quit()
二、APP元素信息信息的获取以及基本的输入操作
|
操作 |
方法 |
|
发送数据 |
.send_keys(vaue) |
|
清空输入框内容 |
.clear() |
|
获取元素的文本内容 |
.text |
|
获取元素的属性值 |
.get_attribute(value) |
|
获取元素在屏幕上的坐标 |
.location |
|
获取app包名和启动名 |
包名：.current_package 启动名：.current_activity |
1 输入发送数据并清空
业务场景:
打开设置à点击搜索按钮à输入并发送数据à情况已输入abc
代码实现：
# 点击搜索按钮
driver.find_element_by_id("com.android.settings:id/search").click()
# 定位到输入框
input_text = driver.find_element_by_id("android:id/search_src_text")
# 输入abc
input_text.send_keys("abc")
# 清空abc
input_text.clear()
2 获取元素的文本内容
业务场景：
1.进入设置
2.获取所有元素class属性为“android.widget.TextView”的文本内容
代码实现：
text_vlaue = driver.find_elements_by_class_name("android.widget.TextView")
for i in text_vlaue:
print(i.text)
执行结果：
设置
无线和网络
WLAN
…
3 获取元素的属性值和坐标
- value='name' 返回content-desc / text属性值
- value='text' 返回text的属性值
- value='className' 返回 class属性值，只有 API=>18 才能支持
- value='resourceId' 返回 resource-id属性值，只有 API=>18 才能支持
业务场景：
1.进入设置
2.获取搜索按钮的content-desc属性值
3.获取搜索按钮在屏幕的坐标位置
代码实现：
# 定位到搜索按钮
get_value = driver.find_element_by_id("com.android.settings:id/search")
# 获取元素的属性值
print(get_value.get_attribute("name")) 结果：搜索
# 打印搜索按钮在屏幕上的坐标
print(get_value.location) 结果：{'y': 44, 'x': 408}
4 获取app包名和启动名
业务场景：
1.启动设置
2.获取包名和启动名
代码实现：
print(driver.current_package)
print(driver.current_activity)
执行结果：
com.tencent.news
.activity.SplashActivity
三、APP元素事件操作API
1.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)
代码实现：
# 滑动没有持续时间
driver.swipe(188,659,148,248)
# 滑动持续5秒的时间
driver.swipe(188,659,148,248,5000)
2.scroll滑动：从一个元素滑动到另一个元素，直到页面自动停止
方法：scroll(origin_el, destination_el)
参数：
1.origin_el：滑动开始的元素
2.destination_el：滑动结束的元素
业务场景：
1.进入设置页
2.模拟手指从存储菜单位置 到 WLAN菜单位置的上滑操作
代码实现：
# 定位到存储菜单栏
el1 = driver.find_element_by_xpath("//*[contains(@text,'存储')]")
# 定位到WLAN菜单栏
el2 = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]")
# 执行滑动操作
driver.scroll(el1,el2)
3.drag拖拽：从一个元素滑动到另一个元素,第二个元素替代第一个元素原本屏幕上的位置
方法：drag_and_drop(origin_el, destination_el)
参数：
1.origin_el：滑动开始的元素
2.destination_el：滑动结束的元素
业务场景：
1.进入设置页
2.模拟手指将存储菜单 滑动到 WLAN菜单栏位置
代码实现：
# 定位到存储菜单栏
el1 = driver.find_element_by_xpath("//*[contains(@text,'存储')]")
# 定位到WLAN菜单栏
el2 = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]")
# 执行滑动操作
driver.drag_and_drop(el1,el2)
4.应用置于后台：APP放置后台，模拟热启动
方法：background_app(seconds)
参数：
1.seconds:停留在后台的时间，单位：秒
业务场景：
1.进入设置页
2.将APP置于后台5s
代码实现：
driver.background_app(5)
效果：
app置于后台5s后，再次展示当前页面
四、APP模拟手势高级操作
TouchAction是AppiumDriver的辅助类，主要针对手势操作，比如滑动、长按、拖动等，原理是将一系列的动作放在一个链条中发送到服务器，服务器接受到该链条后，解析各个动作，逐个执行。 所有手势都要通过执行函数才会运行.
1.手指轻敲操作：模拟手指轻敲一下屏幕操作
方法：tap(element=None, x=None, y=None)
方法：perform() # 发送命令到服务器执行操作
参数：
1.element：被定位到的元素
2.x：相对于元素左上角的坐标，通常会使用元素的X轴坐标
3.y：通常会使用元素的Y轴坐标
业务场景：
1.进入设置
2.点击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()
2.手指按操作：模拟手指按下屏幕,按就要对应着离开
方法:press(el=None, x=None, y=None)
方法：release() # 结束动作，手指离开屏幕
参数：
1.element：被定位到的元素
2.x：通常会使用元素的X轴坐标
3.y：通常会使用元素的Y轴坐标
业务场景:
1.进入设置
2.点击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()
3.手指长按操作：模拟手机按下屏幕一段时间,按就要对应着离开
方法：long_press(el=None, x=None, y=None, duration=1000)
参数：
1.element：被定位到的元素
2.x：通常会使用元素的X轴坐标
3.y：通常会使用元素的Y轴坐标
4.duration：持续时间，默认为1000ms
业务场景:
1.进入设置
2.点击WLAN选项
3.长按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
TouchAction(driver).long_press(x=161,y=242).perform() # 通过这个方法定位时报服务端错误，怀疑是appium1.7.1版本bug
4.等待操作
方法：wait(ms=0)
参数：
ms：暂停的毫秒数
业务场景:
1.进入设置
2.点击WLAN选项
3.长按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() ⚠️ 该方法未能完成长按操作，没有报任何错误
5.手指移动操作：模拟手机的滑动操作
方法：move_to(el=None, x=None, y=None)
参数:
1.el:定位的元素
2.x:相对于前一个元素的X轴偏移量
3.y:相对于前一个元素的Y轴偏移量
业务场景1：
1.进入设置
2.向上滑动屏幕
代码实现：
# 定位到存储
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()
业务场景2：
1.进入设置
2.向上滑动屏幕到可见"安全"选项
3.进入到安全
4.点击屏幕锁定方式
5.点击图案
6.绘制图案
代码实现：
# 定位到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()
# 点击图案按钮
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()
五、手机操作API
1.获取手机时间
方法：device_time
代码实现：
# 获取当前手机的时间
print(driver.device_time)
执行结果：
Wed Dec 27 08:52:45 EST 2017
2.获取手机的宽高，可以根据宽高做一些坐标的操作
方法：get_window_size()
代码实现：
print(driver.get_window_size())
执行结果：
{'height': 800, 'width': 480}
3.发送键到设备，模拟系统键值的操作，比如操作honme键，音量键,返回键等
方法：keyevent(keycode, metastate=None):
参数：
keycode：发送给设备的关键代码
metastate：关于被发送的关键代码的元信息，一般为默认值
业务场景:
1.打开设置
2.按多次音量增加键
代码实现：
for i in range(3):
driver.keyevent(24)
4.操作手机通知栏：打开手机的通知栏，可以获取通知栏的相关信息和元素操作
方法：open_notifications()
业务场景:
1.启动设置
2.打开通知栏
代码实现：
driver.open_notifications()
5.获取手机当前网络
方法：network_connection
业务场景:
获取手机当前网络模式
代码实现：
print(driver.network_connection)
执行结果：
6
6.设置手机网络：更改手机的网络模式，模拟特殊网络情况下的测试用例
方法：set_network_connection(connectionType)
参数：
connectionType：需要被设置成为的网络类型
业务场景：
1.启动设置
2.设置手机网络为飞行模式
代码实现：
driver.set_network_connection(1)
7.手机截图；截取手机当前屏幕，保存指定格式图片到设定位置
方法：get_screenshot_as_file(filename)
参数：
filename：指定路径下，指定格式的图片.
业务场景：
1.打开设置页面
2.截图当前页面保存到当前目录，命名为screen.png
代码实现：
import os
driver.get_screenshot_as_file(os.getcwd() + os.sep + './screen.png')
执行结果：
当前目录下会生成screen.png文件
扫一扫
801
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
