关于android:APP自动化工具uiautomator2

37次阅读

共计 2498 个字符,预计需要花费 7 分钟才能阅读完成。

一、介绍

uiautomator2 是 uiautomator 的升级版,uiautomator 是 Google 开发的一款用来做安卓自动化测试的 Java 库,uiautomator2 则是将 uiautomator 中的接口封装成了 Python 库。因而它反对的语言为 Python

长处次要概括如下:

  环境搭建简略不便
  执行速度很快
  UI 元素定位便捷好用、可视化好
  获取 toast 非常简单 

二、环境部署

1、装置 adb 并配置环境变量 (这个就不多讲了,装置很简略)
2、装置 python 的 uiautomator2 库

pip install uiautomator2

3、装置 atx-agent

python-m uiautomator2 init

 这一步的目标是从 github 上下载 atx-agent,推送到手机,作为服务端,因而先要保障 adb 能够链接到手机或者模拟器
装置胜利后,能够看到模拟器桌面呈现一个小汽车图标,这个就是 atx.apk
 如果装置失败,能够手动装置
这是网上找的一个教程:https://blog.csdn.net/qq_24741027/article/details/118052075

4、装置 weditor

pip3 install weditor

weditor 是基于浏览器的 UI 元素查看器

如果装置报错,官网解决方案为:通过 git 将 weditor 文件拉到本地装置,通过测试并未装置胜利
git clone https://github.com/openatx/weditor
pip3 install -e weditor
 通过屡次测试起因是 python 版本和 weditor 版本不统一
我用的 python 是 3.9.6,weditor 目前最新版本是 0.6.7
应用 weditor==0.6.4 版本装置胜利
pip install weditor==0.6.4
装置好后,在命令行输出 python -m weditor 会主动关上浏览器,在页面上输出模拟器的设施序列号,点击 Connect,而后点击 Dump Hierarchy 刷新,能够看到模拟器的界面

留神:(集体遇到的问题)
装置好启动命令行会有编码问题,site-packages\weditor\web\handlers 下的 shell.py 文件,依据相应的报错将 byte 转换为字符串

三、操作示例

链接手机或者模拟器 (链接形式有多种,ip、端口、或者设施号)

import uiautomator2 as u2
d = u2.connect(“127.0.0.1:62001”)

connect(“10.0.0.1:7912”)
connect(“10.0.0.1”) # use default 7912 port
connect(“http://10.0.0.1”)
connect(“http://10.0.0.1:7912”)
connect(“cff1123ea”) # adb device serial number

检测是否链接胜利,打印 d.info 能够取得设施信息代表链接胜利

关上 app,而后打印 d.info,失去的后果里的 currentPackageName 即是包名

启动指定的 app,其语法是:

d.app_start(“ 指定的包名 ”)

 默认的这种办法是先通过 atx-agent 解析 apk 包的 mainActivity,而后调用 am start -n $package/$activity 启动 

d.app_start(“ 指定的包名 ”, use_monkey=True)

 当第一种形式打不开 app 时,应用第二种打开方式
应用 monkey -p com.example.hello_world -c android.intent.category.LAUNCHER 1 启动
这种办法有个副作用,它主动会将手机的旋转锁定给关掉

关上 weditor UI 查看器

python -m weditor

 鼠标挪动到搜寻点击一下,能够看到有多种定位形式可抉择,例:resourceId、xpath、text

隐性期待语法

d.implicitly_wait(期待时长) 单位是 s, 默认 20 秒

 每一步操作须要加上等待时间,因为下一步的元素控件并不会立刻呈现
隐性期待只须要加一次,全局通用,在期待时长内元素呈现就会进行下一步操作,而不像强制期待始终要等够设置的时长。因而隐性期待绝对比拟节约工夫

元素定位形式示例

resourceId 定位形式 

d(resourceId=’com.xxx.client.android:id/xxx’).click()

xpath 定位形式 

d.xpath(‘//*[@resource-id=”com.xxx.client.android:id/xxx”]’).click()

 依据文本内容定位 

d(text=” 关注 ”).click()
而后能够应用 get_text() 办法拿到文本值,应用 assert 进行断言
assert d(text=” 关注 ”).get_text() == “ 关注 ”

 点击定位 

d.click(0.341, 0.188)

 输出内容 

d.send_keys(“ 大米 ”)

 获取屏幕尺寸 

d.window_size()

滑屏操作

d.swipe(sx,sy,ex,ey,0.5)

 滑屏操作在 uiautomator2 中是 swipe() 办法,和 appium 相似,sx, ex 和 sy,ey 别离示意终点和起点的坐标

比方咱们要向下滑 5 次,因而能够写个 for 循环。这里有几点须要留神下:为了进步屏幕滑动的稳定性,须要退出强制期待,期待 (依据状况自行设定)s
滑动间隔尽量大点,比方 y 轴终点起点能够设置系数别离为 0.9, 0.1,如果你设置为 0.9,0.5,很可能会呈现滑动间隔太小,导致没有滑过去的状况

uiautomator2 还提供了一个扩大的滑动性能,swipe_ext(),不须要坐标,只需提供方向如 "left",“right”,“up”,“down”。通过试验,感觉不太稳固,因而还是采纳惯例的办法

进行 app 并清理环境,这里应用 app_stop() 和 app_clear() 办法

d.app_stop(“com.xxx.client.android”)
d.app_clear(“com.xxx.client.android”)

语法总结

正文完
 0