点击控件的具体位置
d(text="Settings").click(offset=(0.5, 0.5)) 点击控件的中间位置
d(text="Settings").click(offset=(0, 0)) 点击控件的左上方
d(text="Settings").click(offset=(1, 1)) 点击控件的右下方
拖动控件
d(text="Settings").swipe("right") d(text="Settings").swipe("left", steps=10) d(text="Settings").swipe("up", steps=20) d(text="Settings").swipe("down", steps=20)
# 1 steps is about 5ms, so 20 steps is about 0.1s
特定UI对象上的两点手势：从边缘到中心向外，从中心到边缘
# 从边缘到中心
d(text="Settings").pinch_in(percent=100, steps=10) # 从中心到边缘 d(text="Settings").pinch_out()
等待特定的界面出现或者消失
# 等待UI出现 d(text="Settings").wait(timeout=3.0) # return bool # 等待UI消失 d(text="Settings").wait_gone(timeout=1.0)
对特定的UI对象执行Fling（可滚动）默认时间20s
# 向前（默认） d(scrollable=True).fling() # 掷球前水平 d(scrollable=True).fling.horiz.forward() # 垂直向后投掷 d(scrollable=True).fling.vert.backward() # 水平开始 d(scrollable=True).fling.horiz.toBeginning(max_swipes=1000) # 垂直抛向末端 d(scrollable=True).fling.toEnd()
对特定的UI对象执行滚动
水平或垂直
向前或向后，或开始或结束，
# 垂直向前滚动（默认） 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() # 垂直向前滚动，直到出现特定的UI对象
d(scrollable=True).scroll.to(text="Security")
当选择器找不到匹配项时，uiautomator2将运行所有注册的观察程序，条件匹配时单击目标
d.watcher("AUTO_FC_WHEN_ANR").when(text="ANR").when(text="Wait") \ .click(text="Force Close")
#使用不带参数的click
d.watcher("ALERT").when(text="OK").click()
#same as
d.watcher("ALERT").when(text="OK").click(text="OK")
#当条件为真时按键
d.watcher("AUTO_FC_WHEN_ANR").when(text="ANR").when(text="Wait") \ .press("back", "home")
#检查指定的观察程序是否触发一个观察者被触发，这意味着观察者已经运行并且其所有条件都匹配。
# true in case of the specified watcher triggered, else false
d.watcher("watcher_name").triggered #展示所有watch
d.watchers
#通常可以用来自动点击权限确认框，或者自动安装
d.watcher("OK").when(text="OK").click(text="OK") # enable auto trigger watchers d.watchers.watched = True # disable auto trigger watchers d.watchers.watched = False # get current trigger watchers status assert d.watchers.watched == False
#移除watch
# remove all registered watchers d.watchers.remove() # remove the named watcher, same as d.watcher("watcher_name").remove() d.watchers.remove("watcher_name")
全局设置
#用户每次点击后延迟1.5s
d.click_post_delay = 1.5
#设置默认元素超时时间（s）
d.wait_timeout = 30.0 #输入法 d.set_fastinput_ime(True) # 切换成FastInputIME输入法
d.send_keys("你好123abcEFG") # adb广播输入 d.clear_text() # 清除输入框所有内容(Require android-uiautomator.apk version >= 1.0.7) d.set_fastinput_ime(False) # 切换成正常的输入法 d.send_action("search") # 模拟输入法的搜索 uiautomation2哈哈哈哈
)
