技术分享 | app自动化测试(Android)--高级定位技巧
XPath高级定位技巧
XPath 简介
XPath 的英文全称为:XML Path Language,意旨对 XML 中的元素进行路径定位的一种语言,它可适用 XML 标记语言,Html 标记语言,app Dom 结构。XPath 是自动化工具的定位基础,可适用于 Selenium 工具,Appium 工具,Appcrawler 工具。由于前面章节已经对 XPath 进行说明,本篇只做举例说明。
XPath 基本语法
下面是 XPath 的常用方法:
XPath 模糊定位技巧
contains( )方法是模糊匹配的定位方法,对于一个元素的属性不固定,就可以模糊匹配。如://[contains(@content-desc, '帮助')],示例代码:
PYTHON 版本
driver.find_element(By.XPATH,
'//*[contains(@text, "注册")]')
driver.find_element(By.XPATH,
'//*[contains(@content-desc, "搜索")]')
driver.find_element(By.XPATH,
'//*[contains(@resource-id, "login_phone")]')
JAVA 版本
driver.findElement(By.xpath(
"//*[contains(@text, \"注册\")]"));
driver.findElement(By.xpath(
"//*[contains(@content-desc, \"搜索\")]"));
driver.findElement(By.xpath(
"//*[contains(@resource-id, \"login_phone\")]"));
XPath 组合定位技巧
通过 XPath 可以同时匹配 2 个甚至多个属性来完成元素定位。这里常用的属性有 text、resource-id、class、index、content-desc 等,这些属性任意组合完成定位,示例代码:
PYTHON 版本
driver.find_element(
By.XPATH,'//*[@text="我的" and @resource-id="tab_name"]'
).click()
driver.find_element(
By.XPATH,'//*[@text="注册/登录" and @index="1"]'
).click()
JAVA 版本
driver.findElement(By.xpath(
"//*[@text=\"我的\" and @resource-id=\"tab_name\"]")).click();
driver.findElement(By.xpath(
"//*[@text=\"注册/登录\" and @index=\"1\"]")).click();
XPath 层级定位
通常定位元素的时候可能会涉及到通过子元素去定位父元素,或者父元素定位子元素,或者定位兄弟元素,xpath 支持父子关系,兄弟关系元素的查找。示例代码如下:
PYTHON 版本
# 通过子元素定位父元素
# 方法一:..
driver.find_element_by_xpath(
'//*[@text="手机号"]/..').tag_name
# 方法二 parent::*
driver.find_element_by_xpath(
'[@text="手机号"]/parent::*').tag_name
#通过元素定位兄弟元素
driver.find_element_by_xpath(
'//*[@text="手机号"]/../li'
).tag_name
JAVA 版本
// 通过子元素定位父元素
// 方法一:..
driver.findElement(By.xpath(
"//*[@text=\"手机号\"]/..")).getTagName();
// 方法二 parent::*
driver.findElement(By.xpath(
"[@text=\"手机号\"]/parent::*")).getTagName();
// 通过元素定位兄弟元素
driver.findElement(By.xpath(
"//*[@text=\"手机号\"]/../li"
)).getTagName();
案例
场景一:
应用:雪球 apk
可以使用 uiautomatorviewer 工具进行 dom 分析,然后对分析到的元素进行 XPath 定位,比如下面的搜索框,可以使用元素的多种属性进行定位,常用的有 text,resource-id,class,content-desc 等属性。
推荐使用 resource-id 进行定位,通常情况下,它是页面唯一的属性,其 XPath 如下:
PYTHON 版本
driver.find_element(
By.XPATh, '//*[contains(@resource-id, "tv_search")]')
# 或者也可写成下面这样
driver.find_element(By.ID, 'tv_search')
JAVA 版本
driver.findElement(By.xpath("//*[contains(@resource-id,
\"tv_search\")]"));
// 或者也可写成下面这样
driver.findElement(By.id("tv_search"));
场景二:
如下图,获取 “BABA” 所对应的股票价格 “187.11”,可以使用 XPath 父子关系来进行元素定
代码如下:
PYTHON 版本
curr_price = self.driver.find_element(
MobileBy.XPATH,"//*[@text='BABA']/../../..\
//*[@resource-id='com.xueqiu.android:id/current_price']")
JAVA 版本
MobileElement curr_price = driver.findElement(
By.xpath("//*[@text=\"BABA\"]/../../..//\
*[@resource-id='com.xueqiu.android:id/current_price']"));
Android UiAutomator定位技巧
UiAutomator 是 Android SDK 自带的一个测试框架,这个测试框架提供了一系列的 API,可以与 Android APP 进行交互,例如打开菜单,点击,滑动等。当 Appium 的 Caps 参数 uiautomationName 设置为 UiAutomator2 时,就能够实现与手机端的 UiAutomator 进行通信并且使用 UiAutomator 执行测试代码。如果不进行设置,默认也是使用 UiAutomator2 工作引擎。UiAutomator1 是较老的工作引擎,如果想测试较老版本的 Android 系统(低于 Android4.4 版本)需要设置 uiautomationName="UiAutomator1"。
由于 Android UiAutomator 是 Android SDK 中自带的工作引擎,使用这种定位方式,速度上要比 Xpath 定位方式快很多。但由于写法比较特殊,调试起来要相对麻烦,如果定位语句编写不当,脚本编辑器也不会给出任何提示信息。只能在运行的时候校验对错。
下面就单独介绍基于 uiautomator 定位元素的方法,基本语法如下:
- Python 版本
driver.find_element_by_android_uiautomator()
- Java 版本
driver.findElement(MobileBy.AndroidUIAutomator());
常用的方法有:
UiSelector() # 实现元素定位
UiScrollable() # 实现滚动查找元素
通过 TEXT 文本定位
UiSelector( ) 与 XPath 类似,可以通过元素的 text 属性来定位元素。语法格式如下:
new UiSelector().text("text文本")
同样也能用模糊查询的用法去定位元素
例如: new UiSelector().textContains("手机") 示例代码:
- Python 版本
driver.find_element_by_android_uiautomator(
'new UiSelector().textContains("手机")').click()
- Java 版本
driver.findElementByAndroidUIAutomator(\
"new UiSelector().textContains(\"手机\")").click();
通过 RESOURCEID 定位
uiautomator 同样也能进行 id 定位,格式为 new UiSelector().resourceId("resource-id属性"),示例代码:
- Python 版本
driver.find_element_by_android_uiautomator(
'new UiSelector().resourceId("rl_login_phone")').click()
- Java 版本
driver.findElementByAndroidUIAutomator("new UiSelector().\
resourceId(\"rl_login_phone\")").click();
通过 CLASSNAME 定位
页面上的 class 属性一般不唯一,此时可以根据下标进行定位,格式为 new UiSelector().className("className"),一般会使用find_elements完成定位,示例代码:
- Python 版本
driver.find_elements_by_android_uiautomator(
'new UiSelector().\
className("android.widget.TextView")')[5].click()
- Java 版本
driver.findElementsByAndroidUIAutomator("new UiSelector().\
className(\"android.widget.TextView\")")[5].click();
通过 DESCRIPTION 定位
同样的,也支持 contenet-desc 定位方式,格式为:new UiSelector().description("contenet-des属性"),示例代码:
- Python 版本
driver.find_element_by_android_uiautomator(
'new UiSelector().description("搜索")').click()
- Java 版本
driver.findElementByAndroidUIAutomator("new \
UiSelector().description(\"搜索\")").click();
组合定位方式
Uiautomator 也支持组合元素查找功能,示例代码:
- Python 版本
driver.find_element_by_android_uiautomator(
'new UiSelector().resourceId(\
"com.xueqiu.android:id/tv_login_phone").text("手机号")').click()
- Java 版本
driver.findElementByAndroidUIAutomator("new UiSelector().resourceId(\
\"com.xueqiu.android:id/tv_login_phone\").text(\"手机号\")").click();
滚动查找元素
Uiautomator 使用 UiScrollable() 实现了滚动查找元素的功能,可以指定滑动到某个元素,示例代码:
- Python 版本
driver.find_element_by_android_uiautomator(
'new UiScrollable(new UiSelector().scrollable(true)\
.instance(0)).scrollIntoView(new UiSelector()\
.text("我的").instance(0));').click()
- Java 版本
driver.findElementByAndroidUIAutomator(\
"new UiScrollable(new UiSelector().scrollable(true)\
.instance(0)).scrollIntoView(new UiSelector().\
text(\"我的\").instance(0));").click();
上面的代码,在当前的页面滚动的查找 text 文本是“我的”这个元素,找到之后执行点击操作。
css selector元素定位
Appium Server 从 1.19.0 这个版本开始,元素定位增加了 css selector 的支持。appium-uiautomator2-driver 会将 css selector 定位器转化成 android uiautomator 定位方式。
注意:appium inspector 暂时没有添加这种定位方式。
由于 UiSelector() 的表达式是 Java 的语法格式,编写定位元素的表达式很复杂,代码编写工具(比如 Pycharm,VSCode,IntelliJ IDEA等)也不会有任何提示错误信息。只能是运行时才能发现表达式的错误。官方提供了 css selector 的语法,会自动转成 android uiautomator 的语法结构,这种原生的定位元素的方式,定位速度要更快一些。
详情参考官方:https://github.com/appium/appium-uiautomator2-driver/pull/410
源码地址:https://github.com/appium/appium-uiautomator2-driver/blob/master/lib/css-converter.js
id 定位
可以使用 css selector 语法定位。如下代码,#igk 表示 css selector 定位符
- Python 版本
driver.find_element_by_css_selector('#igk')
对应 ID 定位器代码如下:
driver.find_element_by_id('android:id/igk')
- Java 版本
driver.findElementByCssSelector("#igk").click();
对应 ID 定位器代码如下:
driver.findElementById("android:id/igk").click();
class name 定位
如下代码,表示 css selector 定位符为 .android.widget.ImageView 的元素
- Python 版本
driver.find_element_by_css_selector('.android.widget.ImageView')
对应 class name 定位器代码如下:
driver.find_element_by_class_name("android.widget.ImageView")
- Java 版本
driver.findElementByCssSelector(".android.widget.ImageView");
对应 class name 定位器代码如下:
driver.findElementByClassName("android.widget.ImageView");
text 定位
如下代码,表示 css selector 定位符为 *[text='工作台']" 的元素:
- Python 版本
driver.find_element_by_css_selector("*[text='工作台']")
对应 xpath 定位器代码如下:
driver.find_element_by_xpath("//*[@text='工作台']")
- Java 版本
driver.findElementByCssSelector("*[text=\"工作台\"]");
对应 xpath 定位器代码如下:
driver.findElementByXPath("//*[@text=\"工作台\"]");
description 定位
如下代码,表示 css selector 定位符为 *[description="ContentDescription"] 的元素:
- Python 版本
driver.find_element_by_css_selector('*[description="ContentDescription"]')
对应 accessibility id 定位器代码如下:
driver.find_element_by_accessibility_id("ContentDescription")
- Java 版本
driver.findElementByCssSelector("*[description=\"ContentDescription\"]");
对应 accessibility id 定位器代码如下:
driver.findElementByAccessibilityId("ContentDescription");