Uiautomator2命令

手势与设备交互

• 单击
  d.click()
  self.d(resourceId=“com.kwai.global.video.social.kwaigo:id/search_view”).click()
• 双击
  d.double_click(x,y,0.1)
  默认两次点击间隔0.1秒
• 长按
  d.long_click(x,y,0.5)
  默认长按0.5秒
• 滑动
  d.swipe(sx, sy, ex, ey)
  从sx, sy滑动到 ex, ey
• 拖动
  d.drag(sx, sy, ex, ey)
  从sx, sy拖动到 ex, ey
• 滑动点（多用于九宫格解锁）
  d.swipe((X0，Y0)，(X1，Y1)，( x2，y2)， 0.2）
  从（X0，Y0）到点（X1，Y1），然后到点（X2，Y2）
  中间间隔为0.2秒
• 触摸和拨动（不支持百分比位置定位）
  d.touch.down（10，10）＃模拟按下
  time.sleep（0.01）＃向下和移动之间的延迟，自己控制
  d.touch.move（15，15）＃模拟移动
  d.touch.up （）＃模拟抬起
• 备注：
  除了触摸和拨动以外都支持百分比定位
  d.long_click(0.5, 0.5) 表示长按屏幕中心

屏幕相关

• 检索/设置设备方向
  • 可能的方向
    natural or n#自然方向
    left or l
    right or r
    upsidedown or u (can not be set)#倒置的方向
  • 举例
    d.set_orientation(“left”)
    d.set_orientation(“n”)
• 冻结/解冻旋转
  d.freeze_rotation()#冻结
  freeze_rotation(False)#解冻
• 截图
  • 支持安卓4.2以上系统
  • d.screenshot(“home.jpg”)
  • 获取PIL.Image格式化图像，需要安装pillow
    image = d.screenshot() # default format=“pillow”
    image.save(“home.jpg”)
  • 获取opencv格式的图像，需要安装cv2
    import cv2
    image = d.screenshot(format=‘opencv’)
    cv2.imwrite(‘home.jpg’, image)
  • 获取原始jpeg数据
    imagebin = d.screenshot(format=‘raw’)
    open(“some.jpg”, “wb”).write(imagebin)
• 转储UI层次结构
  xml = d.dump_hierarchy()#获取UI层次结构转储内容（unicoded）
• 打开通知或快速设置
  d.open_notification()
  d.open_quick_settings()

获取所选UI对象状态及其信息

• 判断ui对象是否存在
  d.exists()
  self.d(resourceId=“com.kwai.global.video.social.kwaigo:id/item_icon”).exists(timeout=3)
  返回true或false
  timeout=3 如果元素没有出现就延迟3秒
• 获取ui对象的信息
  d(text=“Settings”).info
  输出全部信息（dict类型）
• 获取/设置/清除可编辑字段的文本
  • 获取ui对象的值
    get_text()
    self.d(resourceId=“com.kwai.global.video.social.kwaigo:id/name”, instance=2).get_text()
  • 设置ui对象的值
    d(text=“Settings”).set_text(“My text…”) # set the text
  • 清除ui对象的值
    d(text=“Settings”).clear_text() # clear the text
• 获取ui对象中心点
  x, y = d(text=“Settings”).center()

对选定的UI对象执行点击操作

• 单击选定的ui对象
  • d(text=“Settings”).click()#单击ui对象的中心
  • d(text=“Settings”).click(timeout=10)#延迟10秒点击
  • offset是点击ui对象上的偏移位置
    d(text=“Settings”).click(offset=(0.5, 0.5)) # 点击对象的中心
    d(text=“Settings”).click(offset=(0, 0)) # 点击对象的左上角
    d(text=“Settings”).click(offset=(1, 1)) # 点击对象的右下角
  • ui对象元素存在后点击
    clicked = d(text=‘Skip’).click_exists(timeout=10.0)#延迟10秒
    click_exists(10) #等待10秒
  • 直到ui对象元素消失返回布尔值
    is_gone = d(text=“Skip”).click_gone(maxretry=10, interval=1.0)
    maxretry最大尝试次数，interval间隔时长
• 长按选定的ui对象
  d(text=“settings”).long_click()#长按特定UI对象的中心

选定UI对象的手势操作

• 将ui对象拖向一个点或另一个ui对象
  安卓4.3以下版本不支持
  • 拖向一个点(X,Y)
    d(text=“Settings”).drag_to(x, y, duration=0.5)
  • 拖向另一个元素
    d(text=“Settings”).drag_to(text=“Clock”, duration=0.25)
  • duration为时间限制
• 从UI对象的中心划向其边缘
  • 滑动支持4个方向
    left、right、top、bottom
  • d(text=“Settings”).swipe(“right”, steps=20)#0.1s滑到对象右边
    seps步数，一步约为5ms，20步为0.1s
• 从一个点到另一个点的两点手势
  d(text = “Settings”).gesture((sx1,sy1),(sx2,sy2),(ex1,ey1),(ex2,ey2))
  选定ui对象的两点手势
  • 支持两种
    in：从边缘到中间
    d.princh_in()
    out：从中间到边缘
    d.princh_out()
  • 安卓4.3以下不支持
  • d(text=“Settings”).pinch_in(percent=100, steps=10)
• 等待选定ui对象出现或消失
  d(text=“Settings”).wait(timeout=3.0)
  d(text=“Settings”).wait_gone(timeout=1.0)
  返回布尔值
  默认超时20s
• 在选定ui对象上执行fling（可滚动）
  • 可能的属性
    horiz or vert#水平或垂直
    forward or backward or toBeginning or toEnd#向前、向后、开始、结尾
  • 举例
    d(scrollable=True).fling()#默认垂直向前
    d(scrollable=True).fling.horiz.forward()#水平向前滚动
    d(scrollable=True).fling.vert.toBeginning(max_swipes=1000)#垂直滚动直到开始
    d(scrollable=True).fling.toEnd()#垂直（默认）滚动到最后
• 在选定对象上执行scroll（可滚动）
  • 可能的属性
    horiz or vert#水平或垂直
    forward or backward or toBeginning or toEnd or to#向前、向后、开始、结尾、直到…
  • 举例
    d(scrollable=True).scroll(steps=10)#默认垂直向前
    d(scrollable=True).scroll.horiz.forward(steps=100)
    d(scrollable=True).scroll.vert.backward()
    d(scrollable=True).scroll.horiz.toBeginning(steps=100, max_swipes=1000)
    d(scrollable=True).scroll.toEnd()
    d(scrollable=True).scroll.to(text=“Security”)#垂直向前滚动，直到出现特定的ui对象

其他

• 输入字符
  self.d.send_keys（“你好123abcEFG ”）
• 等待
  import time
  time.sleep(10) #等待10s