恭喜发财dife 发表于 2018-2-23 14:59:40

Appium 基于安卓的各种 FindElement 的控件定位方法实践和建议

AppiumDriver 的各种 findElement 方法的尝试,尝试的目标应用是 SDK 自带的 Notepad 应用。

findElementByName

示例
el = driver.findElementByName("Add note");
assertThat(el.getText(),equalTo("Add note"));如何获得 Name

安卓设备没有找到适合的方法,尝试用 Appium Inspector,但是使用了当前最新的“AppiumForWindows
-1.2.3.1”没有看到这个属性,且 Inspector 在 Windows 下面非常的不稳定,很容易crash。真心期望
Appium团队尽快解决这个问题。iOS设备倒可以用Appium Inspector获得。
建议

个人建议可以尝试先用 view 显示的文本作为 name 看是否能拿到该控件,按照我个人的经验一般都
是会成功的,所以我很怀疑安卓上面控件的 name 是否就等于 text。如果确实还是不行的话就只好
放弃用 name 了。或者等待 Appium 后来的稳定的 inspector发布后看是否可以获得控件的 name。

这个方法在 Appium1.0 之后其实已经过时而要被 findElementByAccessibilityId 取代得了,不知道为
什么还能调用,猜想是Appium团队想保留一定的兼容性以平滑过度吧。请查看:
https://github.com/appium/appium/blob/master/docs/en/advanced-concepts/migrating-to-1-0.md
findElementByAndroidUIAutomator

示例

el = driver.findElementByAndroidUIAutomator("new UiSelector().text(\"Add note\")");
assertThat(el.getText(),equalTo("Add note"));
如何获得UIAutomator参数
UIAutomator获取控件的方式多种多样,都是通过UiSelector对象来去查找,比如使用view的text文
本去当前窗口查找控件,这里不做累述,往后会另起一篇文章来描述UIAUtomator获取控件的方式,
到时直接套用进来就可以了。

findElementByClassName

示例

el = driver.findElementByClassName("android.widget.TextView");
assertThat(el.getText(),equalTo("Add note"));
如何获得控件的 ClassName

可以使用 UIAutomatorViewer 工具直接查看
建议

使用 ClassName 一般获得的 view 都不止一个,所以应该需要遍历一遍得到的 views,然后缩写搜
索条件来获得目标控件。示例中因为只有一个 textview 控件在窗口上面,所以不需要遍历。
findElementById

示例

el = driver.findElementById("android:id/title");
assertThat(el.getText(),equalTo("Add note"));
如何获得Resource Id

可以通过UIAutomatorViewer获得
建议
如果目标设备的API Level低于18则UIAutomatorViewer不能获得对应的Resource ID,只有等于大于
18的时候才能使用。

findElementByAccessibilityId

示例

el = driver.findElementByAccessibilityId("menu_add_note_description");
assertThat(el.getText(),equalTo("node"));
如何获得AccessibilityId
可以通过 UIAutomatorViewer 或者 Appium Inspector 获得。

注释

Accessibility ID 在 Android 上面就等同于 contentDescription。这个属性是方便一些生理功能有缺
陷的人使用应用程序的。比如我们有一个 ImageView 里面放置一张颜色复杂的图片,可能一些色
弱色盲的人,分不清这张图片中画的是什么东西。如果用户安装了辅助浏览工具比如 TalkBack,
TalkBack 就会大声朗读出用户目前正在浏览的内容。TextView 控件 TalkBack 可以直接读出里面
的内容,但是 ImageView,TalkBack 就只能去读 contentDescription 的值,告诉用户这个图片到
底是什么。

鉴于这是一个隐藏属性,而 Android 上用于查找控件的各种属性可能有所缺失或者有重复(比如id
重复,比如一个list下面的所有项可能都是叫做“id/text1”),所以最佳的办法就是跟开发团队沟通
好每个 view 都赋予一个唯一的 contentDescription。
findElementByCssSelector

TBD 这个方法应该是针对WebView容器下面的控件定位的,因为现在针对的是Native App暂时还没
有用到,所以先标记下,今后需要的时候加上去。
findElementByLinkText

TBD, 这个方法应该是针对WebView容器下面的控件定位的,因为现在这很对的是Native App暂时还
没有用到,所以先标记下,今后需要的时候加上去。
findElementByPartialLinkText

TBD, 这个方法应该是针对WebView容器下面的控件定位的,因为现在这很对的是Native App暂时还
没有用到,所以先标记下,今后需要的时候加上去。
findElementByTagName

这个方法 Appium1.0 以后已经过时并被以上的 findElementByClassName 取代了,请查看
https://github.com/appium/appium/blob/master/docs/en/advanced-concepts/migrating-to-1-0.md

findEelementByXPath

示例

java
el = driver.findElementByXPath("//android.widget.TextView");
//el = driver.findElement(By.xpath("//android.widget.TextView"));
assertThat(el.getText(),equalTo("Add note"));
XPath格式变化

从老版本的 Appium0.18.x 升级到现在的 Appium1.x 后,注意 class name 和 xpath 策略的变化:
你现在需要使用 FQCN 来描述你的控件。也就是说原来的:findElementByXpath(""//TextView[contains
(@text,'Add note')]"") 需要改成findElementByXpath("//android.widget.TextView[contains(@text,'Add
note')]")

详细变动请查看《Appium0.18.x迁移到Appium1.x须知事项》
参考
据说不是很稳定:https://github.com/appium/appium/issues/3371
sometimes uiautomator fails to create the dump.xml. A client side retry may help. I don't think there's
much we can do about the problem until Google fixes uiautomator.
终极方法:AppiumDriver getPageSource

最后介绍AppiumDriver的getPageSource函数,可以把当前页面的元素以XML的方式打印出来,建议
大家在找不到view的相应属性的时候就调用该函数来慢慢查找了_^

梦想家 发表于 2018-2-28 16:07:04

:handshake
页: [1]
查看完整版本: Appium 基于安卓的各种 FindElement 的控件定位方法实践和建议