检查并维持设备端守护进程处于运行状态,应该是重启了atx守护进程:d.healthcheck()
1.隐式等待
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()#找到此按钮则直接点击
2.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