**
一、介绍:
相信很多使用 appium 做过 APP 自动化的人都深有感触:

  1. appium 运行慢、时间长
  2. uiautomatorviewer 定位元素时得关掉 appium server
  3. 在低版本的 appium 上获取 toast 需要切换 automationName

现在有一款自动化测试工具 uiautomator2,它几乎完美的避免了以上的问题。简单易学,对新手足够友好。本次我们介绍一下这款工具

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

优点主要概括如下:

  1. 环境搭建简单方便
  2. 执行速度很快
  3. UI 元素定位便捷好用、可视化好
  4. 获取 toast 非常简单
  5. 根据官方文档,要求: Andorid 版本 4.4+ Python 版本 3.6+

二、环境部署
1.先升级 pip

python -m pip install --upgrade pip  -i https://pypi.douban.com/simple
  1. 安装 uiautomator2 py pip install -i https://pypi.tuna.tsinghua.edu.cn/simple --pre -U uiautomator2 3.安装定位元素的包 weditor
# 基于浏览器查看 App 的界面元素
pip install --pre weditor  -i https://pypi.douban.com/simple
备注:安装源可以换#https://pypi.douban.com/simple  豆瓣镜像     和    #https://pypi.tuna.tsinghua.edu.cn/simple 清华镜像

安装 weditor 碰见的问题汇总:

  1. 问题一: py 装weditor时出现error in setup command: Error parsing C:\Users\WANGLI~1\AppData\Local\Temp\pip-install-3stpb4jr\weditor_50cffa0e823948fe8a0436a9af5b9898\setup.cfg: UnicodeDecodeError: 'gbk' codec can't decode byte 0xad in position 825: illegal multibyte sequence: 解决方法:
git clone https://github.com/openatx/weditor
pip3 install -e weditor
参考https://github.com/alibaba/web-editor

4.在手机上安装 atx-agent 应用,
ps:atx-agent 作为服务端,一直运行在后台
执行如下命令,初始化安卓设备

# 安装apk服务到手机上
python -m uiautomator2 init

5.若需要截屏,需要安装 pillow

# 如果需要截屏,需要安装pillow
pip3 install pillow

6.weditor 连接安卓设备如下:
安卓端:
Windows 上运行 Android 端:
打开终端输入命令启动 weditor:
python -m weditor
命令执行成功后会自动调用浏览器打开地址http://localhost:17310/,如图:

选择目标设备 Android
输入命令查看 android 设备 UUID:adb devices
在 WEditor 界面输入设备 UUID
点击 Connect,连接成功
点击 dump hierarchy,即可定位元素

在执行 python -m weditor 这个命令的时候碰见问题汇总
A. 运行 python -m weditor 时,提示:ModuleNotFoundError: No module named 'tornado'
按照提示安装:pip install tornado
B. 再次运行 python -m weditor 时,提示:ModuleNotFoundError: No module named 'wda'
按照提示安装:pip install wda
C. 在安卓手机定位元素碰见的问题如下:

查看 cmd 窗口也报错

在 2022-08-31 在安卓 12MIUI13 机器上碰到以上问题,然后根据https://github.com/alibaba/web-editor/issues/114 这个描述去解决,还是不能解决以上问题。最后换了一个 vivo 手机,能正常元素定位了(备注:https://blog.csdn.net/YUICUI/article/details/125379562 这个解决方法不适用)

iOS 端:
第一步:在定位 iOS 手机查找元素的时候,请先在 iOS 手机上安装 wda 应用,请参考:https://testerhome.com/topics/34299
安装完成之后,脱离 mac 电脑,换成 windows 电脑
第二步:Windows 安装配置 tidevice
1、打开 cmd,输入命令: pip3 install -U "tidevice[openssl]",如图表示安装成功

2、查看 tidevice 版本号验证是否安装成功,打开 cmd,输入命令:tidevice version 或 tidevice -v,如图

3、列出连接的设备,打开 cmd,输入命令:tidevice list 和 tidevice list --json,如图

4、应用管理常用命令

(1)安装应用:tidevice install example.ipa
(2)指定设备安装:tidevice --udid $UDID install https://example.org/example.ipa
(3)卸载应用:tidevice uninstall com.example.demo
(4)启动应用:tidevice launch com.example.demo
(5)停止应用:tidevice kill com.example.demo
(6)查看已安装应用:tidevice applist
(7)查看运行中的应用:tidevice ps 或tidevice ps json output as json

第三步:用 windows 开始定位:
打开终端 1,启动 WDA:
tidevice wdaproxy -B com.xxx.xxx.WebDriverAgent.Runner --port 8200,
如下图,启动 wda 成功

打开终端 2,转发请求到手机:
tidevice relay -x 8100 8100
命令执行之后,如下图,转发成功

浏览器打开http://localhost:8100/,如下图,转发成功:

打开终端 3,启动 weditor:
python3 -m weditor
命令执行成功后会自动调用浏览器打开地址http://localhost:17310/
选择目标设备 iOS
点击 dump hierarchy
运行成功即可

参考文献:https://github.com/alibaba/web-editor


↙↙↙阅读原文可查看相关链接,并与作者交流