自动化测试-uiautomatorviewer.bat

一.认识定位控件(元素定位工具)

• 该工具位于android-sdk-windows\tools\uiautomatorviewer.bat双击即可启动，启动过程中组件所打开的CMD窗口不用关闭；手机开启USB调试，或打开模拟器即可使用
• 在使用Appium的时候，需要填写Desired Capabilities，这里使用Android SDK自带的uiautomatorviewer.bat控件可以便捷的获取所需信息

二.功能及按钮介绍

• 通过截屏并分析XML布局文件的方式，为用户提供控件信息查看服务

• 获取节点元素相关属性
  

• 获取点位坐标
  

• The first button：Open:Screenshot;UI XML Dump打开本地截图和打开.uix格式文件（uix文件需安装Binary Data打开）

• Second button：Device Screenshot(uiautomator dump)设备屏幕截图（uiautomator转储）

• Third button：Device Screenshot with Compressed Hierarchy(uiautomator dump --compressed)具有压缩层次结构的设备屏幕截图

• Save：保存至本地指定位置

• 在Android Studio中可以通过Android Device Monitor 调用UI Automator Viewer

• First button on the right：+Expand All-全部展开

• Second button on the right：Toggle NAF Nodes-切换NAF节点，点击后展示不可被识别的控件

• Third button on the right：Clear search results-清除搜索结果

三.Appuim支持的定位方式

3.01 id定位

• 通过uiautomatorviewer.bat 工具可以查看对象的id属性；
• 如果目标设备的API Level低于18则UIAutomatorViewer不能获得对应的Resource ID，只有等于大于18的时候才能使用；
• resource-id 就是的id属性；
• 使用方法（未验证）：driver.find_element_by_id(‘android:id/text1’).click()；driver.findElement(By.id(“com.android.calculator2:id/formula”))

3.02 name定位

一般text属性认为是name

3.03 className定位

通过调用android uiautomator使用className进行定位

ele = self.driver.find_element_by_android_uiautomator('new UiSelector().className("android.widget.EditText")')
ele.send_keys('132')

3.04 classNameMatches定位

通过className正则匹配进行定位

ele = self.driver.find_element_by_android_uiautomator('new UiSelector().classNameMatches (".*EditText")')
ele.send_keys('132')

3.05 textMatches 正则匹配查找

textMatches故名思义就是通过正则的来进行查找定位，他也是通过text的属性来进行正则匹配

ele = self.driver.find_element_by_android_uiautomator('new UiSelector().textMatches("^请输入手.*")')
ele.send_keys("123")

3.06 textStartsWith定位

driver.find_element_by_android_uiautomator('new UiSelector().textStartsWith("请输入")')

3.07 class_name定位

• 定位一个控件class就是class_name ,一般获得的view都不止一个,所以应该需要遍历一遍得到的views，然后缩小搜索条件来获得目标控件；如果多个只操作第一个driver.find_element_by_class_name("com.jingdong.app.mall:id/ic").click()
• 定位组控件，例如：com.jingdong.app.mall:id/ic;
  driver.find_elements_by_class_name("com.jingdong.app.mall:id/ic")[1].click()，或WebElement button = driver.findElement(By.className(“com.jingdong.app.mall:id/ic”));

3.08父子关系、兄弟关系定位

self.driver.find_element_by_android_uiautomator('new UiSelector().resourceId("com.xueqiu.android:id/title_container").childSelector(text("密码"))')

self.driver.find_element_by_android_uiautomator('new UiSelector().resourceId("com.xueqiu.android:id/title_container").fromParent(text("密码"))')

3.09 滚动查找

self.driver.find_element_by_android_uiautomator('new UiScrollable(new UiSelector().scrollable(true).instance(0)).scrollIntoView(new UiSelector().text("查找的元素文本").instance(0));')

3.10 Accessibility_id定位

参数取content-desc的值：driver.find_element_by_accessibility_id('Accessibility').click()或findElement(By.AccessibilityId("sharebutton"))

3.11 XPath定位

• Appium对于xpath定位执行效率是比较低的，也就是说遇到xpath的定位代码的时候，执行比较慢;迫不得已的情况下尽量不用这个定位方式
  （参数取text的值）driver.find_element_by_xpath('//*[@text="Accessibility"]').click()
  （参数取resource-id的值）driver.find_element_by_xpath('//*[@resource-id="android:id/text1"]').click()
  参数格式：
  1）//class
  2）//class[n]
  3）//class[@属性=“属性值”]
  4）//class[@属性=“属性值” and @属性=“属性值”]
  5）//*[@属性=“属性值”]
  例如：com.jingdong.app.mall:id/ic
driver.findElement(By.xpath("//com.jingdong.app.mall:id/ic"))
driver.find_element_by_xpath('//*[@resource-id="android:id/text1"]').click()
  

agree_continue_xpath = "//*[@text='退出登录']"
 
WebDriverWait(driver, 10, 1).until(EC.visibility_of_element_located((MobileBy.XPATH, agree_continue_xpath)))
driver.find_element_by_xpath(agree_continue_xpath).click()

3.12 contains模糊定位

用于获取toast时，toast文本内容较长，可采用contains包含部分文本的匹配方式;以用来模糊匹配上面的文本属性“退出登录”

agree_continue_xpath = "//android.widget.Button[contains(@text, '退出')]"
 
WebDriverWait(driver, 10, 1).until(EC.visibility_of_element_located((MobileBy.XPATH, agree_continue_xpath)))
driver.find_element_by_xpath(agree_continue_xpath).click()

3.13 AndroidUiAutomator定位元素

AndroidUIAutomator是一个强有力的元素定位方式，它是通过Android UIAutomator类库去找元素，定位方式：findElement(By.AndroidUIAutomator(String UIAuto));
可以选择id，nameclassName，description作为传入的字符串

WebElement el =

driver.findElementByAndroidUIAutomator("new UiSelector().resourceId(\"com.tencent.mm:id/do\")");

3.14 resourceID定位

resourceld定位和appium封装好的id定位一样，差别在写法变成了uiautomator的写法

ele = self.driver.find_element_by_android_uiautomator('new UiSelector().resourceId("cn.com.open.mooc:id/et_phone_edit")')
ele.send_keys('234')

3.15 resourceIDMatches 定位

通过id进行正则匹配定位

ele = self.driver.find_element_by_android_uiautomator('new UiSelector().resourceIdMatches(".+et_phone_edit")')
ele.send_keys('123')

3.16组合定位

xpath中同时包含class和text两个属性

agree_continue_xpath = "//*[@class='android.widget.TextView' and @text='退出登录']"
 
WebDriverWait(driver, 10, 1).until(EC.visibility_of_element_located((MobileBy.XPATH, agree_continue_xpath)))
driver.find_element_by_xpath(agree_continue_xpath).click()

3.17 Android UIAutomator定位

android uiautomator原理是通过android 自带的android uiautomator的类库去查找元素，其实和appium的定位一样，或者说他比appium的定位方式更佳多以及更佳适用，它也支持id、className、text、模糊匹配等进行定位

3.18 支持层级定位

1.driver.find_element_by_xpath("//android.widget.ListView/android.widget.TextView").click()
2.driver.find_element_by_xpath("//android.widget.ListView/*[1]").click()
3.driver.find_element_by_xpath('//*[@resource-id="android:id/list"]/*[1]').click()在父元素API Demos下，Accessibility是第1个子元素;xpath的索引从1开始
4.driver.find_element_by_xpath('//*[@resource-id="android:id/list"]/*[@resource-id="android:id/text1"]').click()
5.driver.find_element_by_xpath('//android.widget.TextView[contains(@text,"Acce")]').click()

• 参数格式：//class[@属性=“属性值”]/class[]/class

3.19 支持部分定位

driver.find_element_by_xpath('//android.widget.TextView[contains(@text,"Acce")]').click()

3.20 Android原生支持元素定位方式

①（参数取resource-id的值）driver.find_element_by_android_uiautomator('new UiSelector().resourceId("android:id/text1")').click()
简化（默认是UiSelector对象）：driver.find_element_by_android_uiautomator('.resourceId("android:id/text1")').click()
例如：WebElement element = driver.findElement(By.id("com.tencent.mm:id/do"));
或driver.findElementById("com.tencent.mm:id/do")
②（参数取class的值）driver.find_element_by_android_uiautomator('.className("android.widget.TextView")').click()
③（参数取text的值）driver.find_element_by_android_uiautomator('.text("Accessibility")').click()

3.21Appium不支持的元素定位方式

3.22 appium与selenium元素定位之比较

appium是app端，用appium需导出selenium包
selenium是web端