uiautomator2 入门教程

一、前言

　　在 Android 自动化测试方面，Google 提供了一个基于 Java 开发的库 UiAutomator，基本上支持所有的 Android 事件操作，使用简单。

在此基础上，有大佬开发出了一个 Python 的第三方库 uiautomator，原理是在手机上运行了一个http rpc服务，将uiautomator中的功能开放出来。

在此之后，因为该库太久没有更新，又有大佬 fork 了一个版本，解决了一些问题，也增加了一些特性，使得功能更加强大了，这个库就叫做 uiautomator2。

二、环境配置

1.ADB 环境

　　以 Windows 系统为例，首先需要下载一个 SDK 工具：https://developer.android.com/studio/releases/platform-tools，下载完成后解压得到如下内容：

　　然后就是添加环境变量了，将该目录路径加入到环境变量中，添加完毕后打开 CMD 窗口输入“adb version”命令，若出现如下内容，则表明环境变量配置成功：

2.Python 环境

　　要使用 uiautomator2，需要 Python3.6 以上的版本，Python 安装成功以后，输入“pip install uiautomator2”安装 uiautomator2。

三、使用方法

　　首先需要一台开启了开发者权限的安卓手机，部分手机的开启步骤为：设置--关于手机--连续点击版本号数次，开启成功后可以在设置里找到类似“开发人员选项”的设置项，然后再打开“USB调试”功能，即可以通过 USB 连接对手机进行调试，最后将手机连接到电脑上，在 CMD 窗口中输入“adb devices”查看当前连接的设备，如下图所示即为连接成功：

　　手机成功连接后，执行如下命令，会在手机上安装一些调试所需的程序，例如 atx-agent。

python -m uiautomator2 init

　　要对手机进行调试，最重要的问题就是如何定位元素，推荐使用工具 weditor 来解决这个问题，该工具只需要执行命令“pip install weditor”即可安装，然后在 CMD 窗口中输入“python -m weditor”会自动在浏览器中打开一个调试页面，如下图所示：

　　“Connect”按钮用于连接设置，左侧输入框可以输入设备号或者 IP 地址（即支持 USB 连接或者通过 WiFi 连接），“Dump Hierarchy”用于进行同步，当你操作手机后，页面可能未同步，就可以点击该按钮进行同步。当然了，也可以在该页面上直接操作手机，例如点击元素、输入内容等，使用还是很方便的。

四、命令简介

1.连接设备

　　支持 USB 或者 WiFi 与设备进行连接，支持同时连接单个或多个设备。

1 import uiautomator2 as u2
2
3
4 # 一个设备时可简写，多个设备时添加设置号参数
5 d = u2.connect(

2.应用操作

 1 import uiautomator2 as u2
 2
 3
 4 d = u2.connect()
 5
 6 # 启动指定应用
 7 d.app_start("com.example.app")
 8 # 启动指定应用，启动前停止此应用
 9 d.app_start("com.example.app", stop=True)
10 # 停止指定应用
11 d.app_stop("com.example.app")
12 # 当前运行中的所有应用
13 d.app_list_running()
14 # 停止所有应用
15 d.app_stop_all()
16 # 安装应用
17 d.app_install(data="./example.apk")

3.触控操作

 1 import uiautomator2 as u2
 2
 3
 4 d = u2.connect()
 5
 6 # 点击
 7 d.click(1, 1)
 8 # 双击
 9 d.double_click(1, 1)
10 # 双击，指定间隔时间
11 d.double_click(1, 1, 0.1)
12 # 长按
13 d.long_click(1, 1)
14 # 长按，指定停留时间
15 d.long_click(1, 1, 5)
16 # 通过元素的文本信息进行点击，会点击文本所在元素的中心位置
17 d(text="Settings").click()
18
19 d.swipe(10, 10, 20, 20)
20 # 右滑
21 d.swipe_ext("right")
22 # 右滑，滑动距离为屏幕宽度的90%
23 d.swipe_ext("right", scale=0.9)
24 # 拖拽
25 d.drag(1, 1, 10, 10)
26
27 # 模拟按下
28 d.touch.down(10, 10)
29 # 模拟移动
30 d.touch.move(15, 15)
31 # 模拟抬起
32 d.touch.up()