python UIAutomator2使用超详细教程

叁歲伎倆 2022-10-30 15:29 514阅读 0赞

一、环境要求  
python 3.6+  
android 4.4+

二、介绍  
uiautomator2 是一个可以使用Python对Android设备进行UI自动化的库。其底层基于Google uiautomator，Google提供的uiautomator库可以获取屏幕上任意一个APP的任意一个控件属性，并对其进行任意操作。

三、库地址  
GitHub地址：  
https://github.com/openatx/uiautomator2

https://github.com/openatx/uiautomator2/blob/master/README.md

四、安装  
1、安装uiautomator2

1  
2  
pip install --pre uiautomator2  
pip install pillow （如果需要截图，可安装这个库）  
2、设备安装atx-agent

首先设备连接到PC，并能够adb devices发现该设备。  
执行下面的命令会自动安装本库所需要的设备端程序：uiautomator-server，atx-agent，openstf / minicap，openstf / minitouch

1  
2  
3  
4  
5  
6  
7  
8  
\# init就是所有USB连接电脑的手机上都安装uiautomator2  
python -m uiautomator2 init  
  
\# 指定手机安装uiautomator2， 用 --mirror  
python -m uiautomator2 init --mirror --serial $SERIAL  
  
\# 嫌弃慢的话，可以用国内的镜像  
python -m uiautomator2 init --mirror  
最后提示success，代表atx-agent初始化成功。

3、安装weditor  
有了这个，方便我们快速的识别手机上的元素，方便写代码

1  
pip install -U weditor  
安装好之后，就可以在命令行运行 weditor --help 确认是否安装成功了。

Windows系统可以使用命令在桌面创建一个快捷方式:

1  
weditor --shortcut  
在windows cmd中执行上述命令后，会在桌面上创建一个快捷方式，如下图：

在这里插入图片描述

启动方法：

方法1.命令行直接输入 weditor 会自动打开浏览器，输入设备的ip或者序列号，点击Connect即可;  
方法2.桌面上双击WEditor快捷方式即可;  
方法3.命令行中执行 python -m weditor

启动后如下图：

在这里插入图片描述

五、应用及操作  
调用uiautomator2的过程

配置手机设备参数，设置具体操作的是哪一台手机  
抓取手机上应用的控件，制定对应的控件来进行操作  
对抓取到的控件进行操作，比如点击、填写参数等。

设备连接方法，有两种：

python-uiautomator2连接手机的方式有两种，一种是通过WIFI，另外一种是通过USB。两种方法各有优缺点。  
WIFI最便利的地方要数可以不用连接数据线，USB则可以用在PC和手机网络不在一个网段用不了的情况。

（1）通过WiFi，假设设备IP 192.168.0.107和您的PC在同一网络中

1  
2  
import uiautomator2 as u2  
d = u2.connect('192.168.0.107')  
（2）通过USB， 假设设备序列是123456789F

1  
2  
3  
import uiautomator2 as u2  
d = u2.connect('123456789F') \# USB链接设备。或者u2.connect\_usb('123456f')  
\#d = u2.connect\_usb() 或者 d = u2.connect() ，当前只有一个设备时可以用这个  
在没有参数的情况下调用u2.connect()， uiautomator2将从环境变量ANDROID\_DEVICE\_IP获取设备IP。如果这个环境变量是空的，uiautomator将返回connect\_usb，您需要确保只有一个设备连接到计算机。

检查并维持设备端守护进程处于运行状态：

1  
d.healthcheck()  
打开调试开关：

1  
2  
d.debug = True  
d.info  
安装应用，只能从URL安装：

1  
d.app\_install('http://some-domain.com/some.apk') \#引号内为下载apk地址  
启动应用：

1  
d.app\_start('com.eg.android.AlipayGphone') \#引号内为包名称，这里为支付宝  
停止应用：

1  
2  
3  
4  
5  
\#相当于'am force-stop'强制停止应用  
d.app\_stop('com.eg.android.AlipayGphone')  
  
\#相当于'pm clear' 清空App数据  
d.app\_clear('com.eg.android.AlipayGphone')  
停止所有正在运行的应用程序：

1  
2  
3  
4  
5  
\# 停止所有  
d.app\_stop\_all()  
  
\# 停止所有应用程序，除了com.examples.demo  
d.app\_stop\_all(excludes=\['com.examples.demo'\])  
跳过弹窗，禁止弹窗：

1  
2  
d.disable\_popups() \# 自动跳过弹出窗口  
d.disable\_popups(False) \# 禁用自动跳过弹出窗  
获取设备信息：

1  
2  
3  
4  
5  
6  
7  
8  
9  
10  
11  
12  
13  
14  
15  
16  
17  
18  
19  
\# 获取基本信息  
d.info  
  
\# 获取窗口大小  
print(d.window\_size())  
\# 设备垂直输出示例: (1080, 1920)  
\# 设备水平输出示例: (1920, 1080)  
  
\# 获取当前应用程序信息。对于某些android设备，输出可以为空  
print(d.current\_app())  
  
\#获取设备序列号  
print(d.serial)  
  
\#获取WIFI IP  
print(d.wlan\_ip)  
  
\#获取详细的设备信息  
print(d.device\_info)  
获取应用信息：

1  
2  
3  
4  
5  
6  
7  
8  
9  
10  
11  
12  
13  
14  
15  
d.app\_info("com.eg.android.AlipayGphone")  
\# 会输出  
'''  
\{  
"packageName": "com.eg.android.AlipayGphone",  
"mainActivity": "com.eg.android.AlipayGphone.AlipayLogin",  
"label": "支付寶",  
"versionName": "10.2.13.9020",  
"versionCode": 360,  
"size": 108306104  
\}  
'''  
\# 保存应用程序图标  
img = d.app\_icon("com.eg.android.AlipayGphone")  
img.save("icon.png")  
推拉文件：  
（1）将文件推送到设备

1  
2  
3  
4  
5  
6  
7  
8  
9  
\# push文件夹  
d.push("foo.txt", "/sdcard/")  
\# push和重命名  
d.push("foo.txt", "/sdcard/bar.txt")  
\# push fileobj  
with open("foo.txt", 'rb') as f:  
d.push(f, "/sdcard/")  
\# 推动和更改文件访问模式  
d.push("foo.sh", "/data/local/tmp/", mode=0o755)  
（2）从设备中拉出一个文件

1  
2  
3  
4  
d.pull("/sdcard/tmp.txt", "tmp.txt")  
  
\# 如果在设备上找不到文件，FileNotFoundError将引发  
d.pull("/sdcard/some-file-not-exists.txt", "tmp.txt")  
关键事件：  
（1）打开/关闭屏幕

1  
2  
d.screen\_on()＃打开屏幕  
d.screen\_off() ＃关闭屏幕  
（2）获取当前屏幕状态

1  
d.info.get('screenOn') \# 需要 Android> = 4.4  
（3）硬键盘和软键盘操作

1  
2  
3  
4  
5  
6  
7  
8  
9  
10  
11  
12  
13  
14  
15  
16  
17  
d.press("home") \# 点击home键  
d.press("back") \# 点击back键  
d.press("left") \# 点击左键  
d.press("right") \# 点击右键  
d.press("up") \# 点击上键  
d.press("down") \# 点击下键  
d.press("center") \# 点击选中  
d.press("menu") \# 点击menu按键  
d.press("search") \# 点击搜索按键  
d.press("enter") \# 点击enter键  
d.press("delete") \# 点击删除按键  
d.press("recent") \# 点击近期活动按键  
d.press("volume\_up") \# 音量+  
d.press("volume\_down") \# 音量-  
d.press("volume\_mute") \# 静音  
d.press("camera") \# 相机  
d.press("power") \#电源键  
（4）解锁屏幕

1  
2  
3  
4  
d.unlock()  
\# 相当于  
\# 1. 发射活动:com.github.uiautomator.ACTION\_IDENTIFY  
\# 2. 按home键