Appium移动自动化测试(三)之元素定位

实验简介

　　做过UI自动化(web自动化, 移动自动化)的同学都会知道, 除去框架的选型和搭建以外, 落到实处的对元素进行定位就成了最重要的技能. 

　　做过UI自动化的同学会知道, 对页面元素的定位方式有8种: id, name, xpath, class, link text, partial link text, tag name, css selector, 使用手法, 优先级的选择以及效率稍有不同, 但是殊途同归, 目标就是要找到元素本身. 

　　同样, 要做Native APP的自动化, 在元素定位上也大同小异, web 元素通用的方式, Appuim也适用, 甚至它还有一些个性化的方式.  但是对于Web View容器下的元素识别, 和web driver并无太多差异

实验目的

　　1. 练习使用工具uiautomatorviewer对元素进行定位

　　2. 熟悉元素定位的方法

　　3. 编写自动化测试用例 - 添加联系人

实验流程

　　1. 首先来看一下测试对象, 一个添加联系人的app, 功能页面如下图排序.

 　　2. 在apk/tools下, 找到uiautomatorviewer.bat

　　　　

　　　　点击如下图标, 同步App页面元素详细信息

　　　　

　　　　3. 从目前的页面上, 我们可以得到一些属性, 其对应关系如下图:

　　　　

　　　　4. 了解了这些基本属性, 其实就可以完成代码的编写了, 如下

#coding=utf-8
from appium import webdriver
import time
from selenium.webdriver.common.by import By

desired_caps = {}
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '23'
desired_caps['deviceName'] = 'Android Emulator'
desired_caps['appPackage'] = 'com.example.android.contactmanager'
desired_caps['appActivity'] = '.ContactManager'

driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
#   点击Add Contact
driver.find_element_by_name('Add Contact').click()  #text
#   输入 Contact Name
name = 'test03'
driver.find_element_by_id('com.example.android.contactmanager:id/contactNameEditText').send_keys(name)  #resource-id
#   输入 Contact Phone
driver.find_element_by_id('com.example.android.contactmanager:id/contactPhoneEditText').send_keys('13111111111')
#   输入 Contact Email
driver.find_element_by_id('com.example.android.contactmanager:id/contactEmailEditText').send_keys('test@test.com')
#   点击 Save Button
driver.find_element_by_name('Save').click()
#   点击 "Show Invisible Contacts(Only)"
driver.find_element_by_accessibility_id('Show Invisible Contacts (Only)').click()
nameAdded = driver.find_element_by_name(name).text
print(nameAdded)
if nameAdded == name:
    print('成功添加联系人.')
else:
    print('添加联系人失败')

driver.quit()

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

　　5. 上面用到了最常用的几种定位方式, 心心念念的强大的xpath还没的提到, 我们来看看它的几种基本用法

　　　　1).使用绝对路径定位，如截图所显示的 xpath 路径
　　　　　　find_element_by_xpath("className/className/className/className")
　　　　2).使用相对路径定位
　　　　　　find_element_by_xpath("//className")
　　　　3).通过元素的索引定位
　　　　　　find_element_by_xpath("//className[index]")
　　　　4).通过元素的属性定位
　　　　　　一种属性：find_element_by_xpath("//className[@label='更多信息']")
　　　　　　两种属性：find_element_by_xpath("//className[@label='更多信息'][@isVisible='1']")
　　　　　　部分属性（最强大）：find_element_by_xpath("//className[contains(@label,'更多')]")

#   输入 Contact Name
name = 'test03'
driver.find_element_by_xpath('//android.widget.EditText["3"]').send_keys(name)

　　6. 使用android uiautomator定位

　　　　这个方法也属于 Appium（Android）扩展的定位方法。同样使用 UIAutomatorViewer.bat 工具直接查看。

　　　　也就是说一个元素的任意属性都可以通过android uiautomator方法来进行定位，但要保证这种定位方式的唯一性。

#  点击 "Show Invisible Contacts(Only)"
driver.find_element_by_android_uiautomator("new UiSelector().text("Show Invisible Contacts (Only)")").click()
# description对应的属性是content-desc
# driver.find_element_by_android_uiautomator("new UiSelector().description("Show Invisible Contacts (Only)")").click()　　

　　　　顺便贴一下UiSelector的其它方法, 依然很好用.

　　　　文本方面的方法：
　　　　　　1.text(String text) 文本
　　　　　　2.textContains(String text) 文本包含
　　　　　　3.textMatches(String regex) 文本正则
　　　　　　4.textStartsWith(String text) 文本开始字符

　　　　描述方面的方法：
　　　　　　1.description(String desc) 描述
　　　　　　2.descriptionContains(String desc) 描述包含
　　　　　　3.descriptionMatches(String regex) 描述正则
　　　　　　4.descriptionStartsWith(String desc) 描述开始字符

driver.find_element_by_android_uiautomator("new UiSelector().descriptionContains("Show Invisible Contacts")").click()

　　曾哥有话说:

　　　　方法find_element_by_android_uiautomator里的语句是用java处理, 它的字符串是放在双引号中的. 如果把字符串放在单引号中的话, 在python里看起来没有问题, 但是java却并不认为这是一个字符串. 错误信息在appuim server上可以清楚地看到:

　　　　

　　　　这个坑挺隐形的, 我趴了好久, 差点以为 该方法在此处不适用, 很难过.