UIAutomator2的API文档（一）

检查并维持设备端守护进程处于运行状态，应该是重启了atx守护进程：d.healthcheck()

１.隐式等待

import uiautomator2 as u2
serialno = '7f3dec60'
d = u2.connect_usb(serialno)
d.implicitly_wait(3.0)

#3秒内未找到“搜索”按钮，则抛出错误uiautomator2.exceptions.UiObjectNotFoundError: -32002 Client error: <> data: , method: None

#此函数会影响以下事件click, long_click, drag_to, get_text, set_text, clear_tex

d(text="搜索").click()#找到此按钮则直接点击

２.App启停基本操作

　2.1安装app（仅支持从URL安装apk）：d.app_install('http://some-domain.com/some.apk')

　　 卸载app：d.app_uninstall(pk_name)

　2.2启动app：d.app_start(package_name)

　2.3停止app：d.app_stop(package_name) #等同于`am force-stop`强制停止app，可能会丢失数据

d.app_clear(package_name)#等同于`pm clear`

　2.4停止所有app：d.app_stop_all(excludes=[package_name])#停止所有app除了括号内的，括号内容可选

　2.5获取app信息：d.app_info(package_name)

　　保存app icon：img=d.app_icon(pkname)

　　　　　　　　　img.save("icon.png")

3.文件推送/拉取

　3.1推送文件到设备中：d.push("foo.txt", "/sdcard/")

　3.2推送文件并重命名：d.push("foo.txt", "/sdcard/bar.txt")

　3.3推送文件对象：with open("foo.txt", 'rb') as f:

　　　　　　　　　d.push(f, "/sdcard/")

　3.4推送并改变文件访问权限：d.push("foo.sh", "/data/local/tmp/", mode=0o755)　　

　3.5从设备中拉取文件到本地：d.pull("/sdcard/tmp.txt", "tmp.txt")

　3.6从设备中拉取的文件不存在时 抛出错误:FileNotFoundError：d.pull("/sdcard/some-file-not-exists.txt", "tmp.txt")

这里顺便说下快速获取apk相关包名信息的一些简易方法

a.获取包名：d.app_stop_all()，会列出一个当前打开的所有app的包名列表；

　print(d.current_app())　打印当前运行的app信息

b.命令行打印安装的所有包：adb shell pm list packages -3

c.打印安装包路径：adb shell pm path "包名"

d.打印安装包信息：aapt d badging "apk包路径"

4.自动点击权限对话框

官方说：disable_popups函数，检测发现很不稳定，暂时不要使用－－一会儿试试看

d.disable_popups() #自动跳过弹出框

d.disable_popups(False) # 禁用自动跳过

如果此方法无法在你的设备上运行，可以按如下步骤操作获取控件

　 4.1打开Open uiautomatorviewer.bat

　 4.2获取弹出框hierarchy

5.执行shell命令

output, exit_code = d.shell("pwd", timeout=60) # timeout 60s (Default)
# output: "/\n", exit_code: 0
# Similar to command: adb shell pwd

# Since `shell` function return type is `namedtuple("ShellResponse", ("output", "exit_code"))`
# so we can do some tricks
output = d.shell("pwd").output
exit_code = d.shell("pwd").exit_code
The first argument can be list. for example

output, exit_code = d.shell(["ls", "-l"])
# output: "/....", exit_code: 0

6.通过会话操作app

启动微信：sess=d.session("com.tencent.mm")

停止微信：sess.close()

使用python操作app，打开微信→点击腾讯新闻→关闭app

with d.session("com.tencent.mm") as sess:
　　sess(text="腾讯新闻").click()

添加app到正在运行状态：sess=d.session("包名",attach=True)

检查app运行状态：sess.running()  #返回True或False

7.获得设备基本信息

设备概要信息：d.info　　

设备详细信息：d.device_info

设备窗口尺寸：d.window_size() 　　

当前运行app信息：d.current_app()　　

设备序列号：d.serial

设备Wlanip：d.wlan_ip　　

等待Activity：d.wait_activity("com.tencent.mm.ui.LauncherUI",timeout=5)#若不设置默认超时10秒，返回True or False