一、移动端定位元素的工具uiautomatorviewer

1、AndroidSDK自带的工具uiautomatorviewer

简介：

        用来扫描和分析Android应用程序的UI控件的工具

2、使用方法：

①、进入SDK目录下的tools目录，打开uiautomatorviewer

②、电脑连接真机或打开android模拟器

③、启动待测试app

④、点击uiautomatorviewer的左上角Device Screenshot,会生成app当前页面的UI控件截图

 

 

二、案例操作

1、通过id定位，进入设置页面点击搜索按钮

 

 

 2、通过class定位输入框

3、xpath定位WLAN按钮  

方法：find_element_by_xpath(xpath_value) # xpath_value:为可以定位到元素的xpath语句



*** android端xptah常用属性定位：
      1. id ://*[contains(@resource-id,'com.android.settings:id/search')] 
      2. class ://*[contains(@class,'android.widget.ImageButton')]
      3. text ://*[contains(@text,'WLA')]

*** 模糊定位 contains(@key,value): value可以是部分值

 

4、定位一组元素,注意element -> elements 

应用场景为元素值重复，无法通过元素属性直接定位到某个元素，只能通过elements方式来选择，返回一个定位对象的列表.

 ①通过id定位一组元素（进入设置，点击WLAN菜单栏（id定位对象列表中第一个））

方法： find_elements_by_id(id_value) # id_value:为元素的id属性值

 

 ②通过class方式定位一组元素（进入设置，点击WLAN菜单栏（xpath中class定位对象列表中第四个））

方法:find_elements_by_xpath(xpath_value) # xpath_value:为可以定位到元素的xpath语句

 5、WebDriverWait 显示等待操作

        在一个超时时间范围内，每隔一段时间去搜索一次元素是否存在，如果存在返回定位对象，如果不存在直到超时时间到达，报超时异常错误。

方法:WebDriverWait(driver, timeout, poll_frequency).until(method)
    参数：
        1.driver：手机驱动对象
        2.timeout：搜索超时时间
        3.poll_frequency：每次搜索间隔时间，默认时间为0.5s
        4.method：定位方法(匿名函数)

    匿名函数: 
        lambda x: x
    等价于python函数：
        def test(x):
            return x

    使用示例：
        WebDriverWait(driver, timeout, poll_frequency).until(lambda x: x.find_elements_by_id(id_value))
    解释：
        1.x传入值为：driver，所以才可以使用定位方法.
    函数运行过程：
        1.实例化WebDriverWait类，传入driver对象，之后driver对象被赋值给WebDriverWait的一个类变量：self._driver
        2.until为WebDriverWait类的方法，until传入method方法(即匿名函数)，之后method方法会被传入self._driver
        3.搜索到元素后until返回定位对象，没有搜索到函数until返回超时异常错误.

 ①进入设置，通过id定位方式点击搜索按钮

6、发送数据到输入框

方法：send_keys(vaue) # value：需要发送到输入框内的文本

 

如果输入中文无搜索结果，但是不报错，解决方法：

 1.server 启动参数增加两个参数配置
            desired_caps['unicodeKeyboard'] = True
            desired_caps['resetKeyboard'] = True

        2.再次运行会发现运行成功
            # 点击搜索按钮
            driver.find_element_by_id("com.android.settings:id/search").click()
            # 定位到输入框并输入文字内容
            driver.find_element_by_id("android:id/search_src_text").send_keys("蓝牙")

7、清空输入框内容

 方法：clear()

8、获取元素的文本内容

 方法: text

1.进入设置
2.获取所有元素class属性为“android.widget.TextView”的文本内容

9、获取元素的属性值

  方法: get_attribute(value) # value:元素的属性
  value='name' 返回content-desc / text属性值
  value='text' 返回text的属性值
  value='className' 返回 class属性值，只有 API=>18 才能支持
  value='resourceId' 返回 resource-id属性值，只有 API=>18 才能支持

1.进入设置
2.获取搜索按钮的content-desc属性值

 

 

10、获取元素在屏幕上的坐标

方法:location

1.进入设置页面
2.获取搜索按钮在屏幕的坐标位置 

 

11、获取app包名和启动名

  获取包名方法：current_package
  获取启动名：current_activity

1.启动设置
2.获取包名和启动名

 

12、swip滑动事件

从一个坐标位置滑动到另一个坐标位置,只能是两个点之间的滑动
  方法：swipe(start_x, start_y, end_x, end_y, duration=None)
  参数：
      1.start_x：起点X轴坐标
      2.start_y：起点Y轴坐标
      3.end_x：  终点X轴坐标
      4.end_y,： 终点Y轴坐标
      5.duration： 滑动这个操作一共持续的时间长度，单位：ms

1.进入设置
2.从坐标(148,659)滑动到坐标(148,248)

13、scroll滑动事件

从一个元素滑动到另一个元素，直到页面自动停止
  方法：scroll(origin_el, destination_el)
  参数：
      1.origin_el：滑动开始的元素
      2.destination_el：滑动结束的元素

1.进入设置页
2.模拟手指从存储菜单位置 到 WLAN菜单位置的上滑操作

14、drag拖拽事件

从一个元素滑动到另一个元素,第二个元素替代第一个元素原本屏幕上的位置
  方法：drag_and_drop(origin_el, destination_el)
  参数：
      1.origin_el：滑动开始的元素
      2.destination_el：滑动结束的元素

1.进入设置页
2.模拟手指将存储菜单 滑动到 WLAN菜单栏位置

三、APP模拟手势高级操作

    TouchAction是AppiumDriver的辅助类，主要针对手势操作，比如滑动、长按、拖动等，
    原理是将一系列的动作放在一个链条中发送到服务器，服务器接受到该链条后，解析各个动作，逐个执行。

 1、手指轻敲操作

  模拟手指轻敲一下屏幕操作
  方法：tap(element=None, x=None, y=None)
  方法：perform() # 发送命令到服务器执行操作
  参数：
      1.element：被定位到的元素
      2.x：相对于元素左上角的坐标，通常会使用元素的X轴坐标
      3.y：通常会使用元素的Y轴坐标

1.进入设置
2.点击WLAN选项

①：通过元素定位方式敲击屏幕

 ②：通过坐标方式敲击屏幕，WLAN坐标:x=155,y=250

 

 2、手指按操作

模拟手指按下屏幕,按就要对应着离开.
  
方法:press(el=None, x=None, y=None)
  方法：release() # 结束动作，手指离开屏幕
  参数：
      1.element：被定位到的元素
      2.x：通常会使用元素的X轴坐标
      3.y：通常会使用元素的Y轴坐标

1.进入设置
2.点击WLAN选项

①：通过元素定位方式按下屏幕

 

②：通过坐标按下屏幕

 

 

3、等待操作

  方法：wait(ms=0)
  参数：
      ms：暂停的毫秒数

1.进入设置
2.点击WLAN选项
3.长按WiredSSID选项5秒

①：通过元素定位长按元素

②：通过坐标方式长按元素

 

 

4、手指长按操作

模拟手机按下屏幕一段时间,按就要对应着离开.  

方法：long_press(el=None, x=None, y=None, duration=1000)
  参数：
      1.element：被定位到的元素
      2.x：通常会使用元素的X轴坐标
      3.y：通常会使用元素的Y轴坐标
      4.duration：持续时间，默认为1000ms

1.进入设置
2.点击WLAN选项
3.长按WiredSSID选项5秒

①：通过元素定位方式长按

 ②：通过坐标方式长按

 

5、手指移动操作

  模拟手机的滑动操作
  方法：move_to(el=None, x=None, y=None)
  参数:
      1.el:定位的元素
      2.x:相对于前一个元素的X轴偏移量
      3.y:相对于前一个元素的Y轴偏移量

1.进入设置
2.向上滑动屏幕到可见"安全"选项
3.进入到安全
4.点击屏幕锁定方式
5.点击图案
6.绘制图案

    代码实现：
        # 定位到WLAN
        el1 = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]")
        # 定位到存储
        el2 = driver.find_element_by_xpath("//*[contains(@text,'存储')]")
        # 存储上滑到WLAN
        driver.drag_and_drop(el2,el1)
        # 定位到用户
        el3 = driver.find_element_by_xpath("//*[contains(@text,'用户')]")
        # 注意 这次使用drag_and_drop方法，传入的"存储定位"仍使用其原始在屏幕上的位置，所以是由存储滑动到用户才可以上滑，否则需要重新"定位存储"
        # 存储上滑倒用户位置
        driver.drag_and_drop(el2,el3)
        # 点击安全按钮
        driver.find_element_by_xpath("//*[contains(@text,'安全')]").click()
        # 点击屏幕锁定方式按钮
        driver.find_element_by_xpath("//*[contains(@text,'屏幕锁定')]").click()
        # 点击图案按钮
        driver.find_element_by_xpath("//*[contains(@text,'图案')]").click()
        # 绘制图案四个坐标 1:(244,967) 2:(723,967) 3:(723,1442) 4:(244,1916)
        TouchAction(driver).press(x=244,y=967).wait(100).move_to(x=479,y=0).wait(100)\
            .move_to(x=0,y=475).wait(100).move_to(x=-479,y=474).release().perform()