AppUI 元素定位操作

元素定位操作

一、 Appium 脚本架构

进行 Appium 自动化测试之前,需启动 Appium 及被测对象,启动了 Appium 客户端后,利用编程工具执行脚本时, Appium 才能将脚本与被测设备建立联接,从而实现自动化测试。

如果不启动客户端,则不能使用 WebDriver。

脚本中需首先导入 WebDriver,然后配置 Server,告诉 Appium 测试环境。

使用 Desired_caps 函数进行设备联接信息。设备连接参数主要有以下常用参数

  • desired_caps={}:设备参数信息,声明为一个字典
  • desired_caps['platformName']:应用平台的类型,通常为 Android 或 IOS
  • desired_caps['platformVersion']:被测设备系统版本
  • desired_caps['deviceName']:设备名称,通过 adb devices 查看
  • desired_caps['appPackage']: Android 应用程序包的包名
  • desired_caps['appActivity']: Android 应用包中需启动的 Activity 名称,通常需要最先声明。
    • Activity 可通过源代码直接看到,如果没有源代码,则可以反向编译或者通过打印的方式检测
  • desired_caps['unicodeKeyboard']:设置键盘输入法类型为 unicode,默认值为 False
  • desired_caps['resetKeyboard']: Unicode 测试结束后,重置输入法到原有状态。默认值为 False
  • driver=webdriver.Remote('http://127.0.0.1:4723/wd/hub',desired_caps) 设置监听的端口信息。

实例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
from appium import webdriver

# 下述内容,描述了appium与设备的通信信息,如果关联信息不正确,则无法实施测试
desired_caps = {
"platformName": "Android", # 指定应用平台的类型 Android 或 IOS
"platformVersion": "10", # 被测设备的版本号
"deviceName": "dsada", # 设备名称 adb devices
"AppPackage": "dsad", # 应用程序包名
"appActivity": "dsa", # 应用程序中需启动的Activity类名
"unicodeKeyboard": "Ture", # 设置输入法类型,这个值默认为 False
"resetKeyboard": "Ture", # 测试结束后,重置输入法到原有状态,这个值默认为 False
# 但是 resetKeyboard 参数,经常不起作用,这就导致,我们在执行代码后,经常要去设置里,手动把输入法类型改回去
"noReset": "True", # 自动化不会重置app
"newCommandTimeout": 6000, # 设置 session 超时时间,单位是秒,默认60秒
"automationName": "UiAutomator2" # 指定驱动版本(优先选用 UI2,如果UI2不行,再换用UI1
}

# 这一步,会打开配置字典中指定的APP
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)

二、 UIAutomatorviewer 查找元素

利用 Appium 实现 App 自动化测试时,与 Selenium 测试 Web 系统一样,同样需要定位 UI 中的元素,在 Android-Sdk 中提供了 UIAutomatorviewer 工具用来查看 UI 中的元素。

appium 的元素定位语法,比 selenium 要难看

1. 首先,将手机连接到电脑
  1. 手机如果弹出连接选择,不要选仅充电,选传文件
  2. 电脑上使用 adb devices 可以搜索到手机设备
2. 打开 appium 桌面应用

image-20210820162037923

  1. 编辑配置

    image-20210820162423391

  2. 启动服务器

    image-20210823104726522

  3. 启动检测器

    image-20210823104831728

  4. 将设备连接信息填入右下角的 JSON 串里

  5. 启动回话后,加载完成后,就进入了元素定位页面

    image-20210823105635168

三、 元素定位

1. 普通定位方法

1.通过 id 定位(取 resource-id 的值):

1
driver.find_element_by_id("com.taobao.idlefish:id/tx_id")

2.通过 class_name 定位(取 class 的内容)

1
driver.find_element_by_class_name("android.widget.RelativeLayout")

3. 通过 AccessibilityId 定位(取 content-desc 内容)

1
driver.find_element_by_accessibility_id("gfdgfdg")

4. 通过 xpath 定位(取 xpath 得内容)

和我们学到的 selenium 里的 xpath 语法一样,只不过用 class 名取代 tag 名

属性方面,相对于 web ui,这里只有 class 属性和文本

4.1通过 xpath 定位, 文本定位
1
driver.find_element_by_xpath("//*[@text='搜索']").click()
4.2 contains 文本模糊定位
1
2
3
4
5
# 文本模糊定位
driver.find_element_by_xpath("//*[contains(@text, '索')]")

# 结合 class 的 文本模糊定位
dirver.find_element_by_xpath("//android.widget.Button[contains(@text, '索')]")
4.3下标
1
driver.find_element_by_xpath("//android.widget.ScrollView/*[7]").click()
4.4 组合定位 —- 同时使用 class 和 文本
1
driver.find_element_by_xpath("//*[@class='android.widget.Button' and @text='同意并继续']"
4.5 组合定位 —- 同时使用 class 和 模糊文本
1
"[@class='android.view.View' and contains(@text, '显瘦牛仔裤')]"

driver.find_element_by_XXX # 符合条件的第一个元素,找不到抛出异常

driver.find_elements_by_XXX # 符合条件的所有元素的列表,找不到返回空列表

2. 通过 Android UIAutomator 定位

根据文本定位
1
driver.find_element_by_android_uiautomator('new UiSelector().text("搜索你想要的")')
根据文本模糊定位
1
driver.find_element_by_android_uiautomator('new UiSelector().textContains("搜索你")')
以 text 什么开始
1
driver.find_element_by_android_uiautomator('new UiSelector().textStartsWith("搜索你")')
正则文本匹配
1
driver.find_element_by_android_uiautomator('new UiSelector().textMatches("^搜索.*")')
resourceID 定位
1
driver.find_element_by_android_uiautomator('new UiSelector().resourceId("cn.com.open.mooc:id/et_phone_edit")')
也是 id 匹配,但是支持正则
1
driver.find_element_by_android_uiautomator('new UiSelector().resourceIdMatches(".+et_phone_edit")')
class name 定位
1
driver.find_element_by_android_uiautomator('new UiSelector().className("android.widget.EditText")')
支正则的 class name 定位
1
driver.find_element_by_android_uiautomator('new UiSelector().classNameMatches (".*EditText")')
可以将多个条件,以链条的方式组合在一起定位
1
driver.find_element_by_android_uiautomator('new UiSelector().resourceId("com.xueqiu.android:id/tab_name").text("我的")')
支持父子关系定位
1
driver.find_element_by_android_uiautomator('newUiSelector().resourceId("com.xueqiu.android:id/title_container").childSelector(text("股票"))')

四、 元素等待

1. 隐式等待

1
driver.implicitly_wait(10)

2. 显式等待

1
2
3
4
5
WebDriverWait(driver=driver, timeout=10, poll_frequency=1).until(
EC.visibility_of_element_located(
(By.XPATH, "?????")
)
)

五、 元素操作

输入中文

1
2
desire_caps['unicodeKeyboard'] = True
desire_caps['resetKeyboard'] = True
1.click() —- 点击操作
1
driver.find_element_by_id("com.wuba.zhuanzhuan:id/ae8").click()
2.clear() —- 清空输入框内容
1
driver.find_element_by_id("com.wuba.zhuanzhuan:id/ij").clear()
3.send_keys(xx) —- 输入框内输入内容
1
driver.find_element_by_id("com.wuba.zhuanzhuan:id/ij").send_keys("test content")
4.text —- 获得元素的 text 内容
1
print(driver.find_element_by_xpath(" //android.widget.LinearLayout[1]//xxx").text)
5.get_attribute —- 获得元素的属性值
1
element.get_attribute(value) #value 为元素的属性名
6.获取元素位置和大小
1
2
element.location  # 获得元素位置
element.size # 获得元素大小
7、滑动和拖拽事件

image-20210823144636064

持续时间越长,惯性越小

参数分别为开始的 x 轴、 y 轴,结束的 x 轴、 y 轴,以及持续时间-单位毫秒

1
driver.swipe(start_x,start_y,end_x,end_y,duration=None)  

从手工操作的角度来说,

从上往下滑动的时候,通常会按下( X1, Y1)坐标,然后往下滑动,一直滑到( X2, Y2)这个坐标。

从下往上滑动的时候,会按( X2,Y2)这个坐标,往上滑动到( X1, Y1)这个坐标。

从左往右进行滑动和从右往左进行滑动的思路都是一样的。

1. 屏幕滑动
1
2
3
4
5
# 获取设备的宽度
x=driver.get_window_size()['width']

# 获取设备的长度
y=driver.get_window_size()['height']

上边的方法可以通过 python 代码获得手机的长宽,然后计算比例

简单的无目的滑动,可以封装成函数 :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# t 代表滑动持续时间,n代表滑动次数

def swipeUp(driver, t=500, n=1):
"""向上滑动屏幕,每次滑动半个屏幕"""
l = driver.get_window_size()
x1 = l["width"] * 0.5
y1 = l["height"] * 0.75
y2 = l["height"] * 0.25
for i in range(n):
driver.swipe(x1, y1, x1, y2, t)

def swipeDown(driver, t=500, n=1):
'''向下滑动屏幕'''
l = driver.get_window_size()
x1 = l['width'] * 0.5
y1 = l['height'] * 0.25
y2 = l['height'] * 0.75
for i in range(n):
driver.swipe(x1, y1, x1, y2,t)

def swipLeft(driver, t=500, n=1):
'''向左滑动屏幕'''
l = driver.get_window_size()
x1 = l['width'] * 0.75
y1 = l['height'] * 0.5
x2 = l['width'] * 0.25
for i in range(n):
driver.swipe(x1, y1, x2, y1, t)

def swipRight(driver, t=500, n=1):
'''向右滑动屏幕'''
l = driver.get_window_size()
x1 = l['width'] * 0.25
y1 = l['height'] * 0.5
x2 = l['width'] * 0.75
for i in range(n):
driver.swipe(x1, y1, x2, y1, t)
2. 元素滑动

可以按元素滑动, 下面函数,会从ele1滑动到ele2,没有惯性

1
driver.drag_and_drop(ele1, ele2)

从一个元素,滑到另一个元素,有惯性

1
driver.scroll(ele1, ele2)