两分钟搞懂UiAutomator自动化测试框架

news2025/1/15 23:20:42

1. UiAutomator简介

UiAutomator是谷歌在Android4.1版本发布时推出的一款用Java编写的UI测试框架，基于Accessibility服务。其最大的特点就是可以跨进程操作，可以使用UiAutomator框架提供的一些方便的API来对安卓应用进行一系列的自动化测试操作，如点击、滑动、键盘输入、长按以及常用的断言方法等。

要使用该工具，需要满足如下条件：

Android SDK Tools, Revision 21 or higher
Android SDK Platform, API 18 or higher

在Android SDK 4.3中提供了如下工具来支持UI自动化测试：

uiautomatorviewer – 一个图形界面工具来扫描和分析应用的UI控件。存放在tools目录。

uiautomator – 一个测试的Java库，包含了创建UI测试的各种API和执行自动化测试的引擎。

在这里插入图片描述
虽然利用Google提供的uiautomator库可以获取屏幕上任意一个APP的任意一个控件属性（非NAF Nodes节点除外），并对其进行任意自动化操作，但却存在两个缺点：

1、测试脚本只能使用Java语言。
2、测试脚本必须每次被上传到设备上运行。

2. UiAutomator2由来

我们从上述可以知道uiautomator库，只能使用Java语言，并且测试脚本需要打包成Jar包上传到设备上才能运行。

但是我们希望测试能够用一个更脚本化的语言，例如Python编写，同时可以每次所见即所得地修改测试、运行测试或者是说能够在电脑上运行就能控制手机。因此基于这种需求背景之下，诞生出来的uiautomator2。

早期，它是由一个名为Xiaocong He的大牛将这个想法实现了出来，实现原理是在手机上运行了一个http rpc服务，将uiautomator中的功能开放出来，然后再将这些http接口封装成Python库。

GitHub项目地址：

https://github.com/xiaocong/uiatomator.git

但由于xiaocong/uiautomator这个库，已经很久不见更新。因此在这个库的基础上，又重新诞生了另外一个加强版本，为了方便做区分原作者在后面加了个2 名为：openatx/uiautomator2

GitHub项目地址：

https://github.com/opentx/uiaomator2.git

该项目除了对原有的库的bug进行了修复外，还增加了很多新的Feature。主要有以下部分：

设备和开发机可以脱离数据线，通过WiFi互联（基于atx-agent）
集成了openstf/minicap达到实时屏幕投频，以及实时截图
集成了openstf/minitouch达到精确实时控制设备
修复了xiaocong/uiautomator经常性退出的问题
代码进行了重构和精简，方便维护
实现了一个设备管理平台(也支持iOS) atxserver2
扩充了toast获取和展示的功能

PS：目前市面上，常提及的uiautomator2测试框架，大部分指的是openatx/uiautomator2这个了，该框架更详细的介绍，可查阅项目文档。

3. 牛刀小试

1、先准备一台开启了开发者选项的安卓手机，连接上电脑，此处直接打开夜神安卓模拟器。

2、确保执行adb devices可以看到连接上的设备。

在这里插入图片描述
3、运行pip3 install -U uiautomator2 安装uiautomator2。

4、运行python3 -m uiautomator2 init安装包含httprpc服务的apk到手机。

在这里插入图片描述
上述初始化命令会自动安装本库所需要的设备端程序：uiautomator-server、atx-agent、openstf/minicap、openstf/minitouch，并且在被测手机终端上会安装一个名为ATX的代理程序。

在这里插入图片描述
按照项目文档中的介绍，在之前的版本中，初始化这一步是必须执行的，但是从1.3.0之后的版本，当运行python代码u2.connect()时就会自动推送这些依赖文件了。

5、接下来在做自动化测试之前，需要先查看获取到被测应用控件信息，一般来说，可以借助Android SDK自带的uiautomatorviewer来查看元素，但这要求手机必须以USB的方式连接PC，但openatx项目中提供了另外一个工具weditor 来解决这个问题。

6、安装weditor在线元素查看器。

pip3 install --pre -U weditor

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

7、命令行直接输入 weditor 会自动打开浏览器（http://localhost:17310/），输入设备的ip或者序列号，点击Connect即可。

在这里插入图片描述
8、编写自动化测试脚本，在下述脚本中，通过connect方法连接到指定设备，再通过app_start方法启动被测应用（脚本示例中，打开的是酷狗音乐App），再依次点击登录按钮，以及判断点击登录按钮后，帐号登录页面是否显示，最后关闭酷狗音乐。

import uiautomator2 as u2
d = u2.connect('127.0.0.1:62001')
print(d.info)
d.app_start("com.kugou.android", ".app.splash.SplashActivity")
d(text="登录").click()
d(text="帐号登录").wait(timeout=10.0)
d.app_stop("com.kugou.android")

如果你觉得文章还不错，请大家点赞分享下。你的肯定是我最大的鼓励和支持。