备案控制台
探索云世界
开发者社区 开发与运维 文章 正文

APP自动化测试框架-UiAutomator2基础

2022-09-25 759
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： UiAutomator2是一款强大的Android自动化测试框架

前言

很早以前，我用uiautomator+java实践过Android APP自动化测试，不过今天要提的不是uiautomator，而是uiautomator2。听起来uiautomator2像是uiautomator的升级版，但是这两款框架仅仅是名字上比较相似，实际上没有任何关联。

一、uiautomator/uiautomator2的前生今世

项目地址：https://github.com/openatx/uiautomator2

1.官方文档介绍

2.梳理一下脉络

  • 先有的谷歌uiautomator，但是只支持java；
  • 后来一个名为hexiaocong的开发者基于uiautomator封装了python版本，支持python代码运行；
  • 而受其启发，uiautomator2作者开发了uiautomator2。所以它们的诞生顺序应该是：uiautomator(谷歌版)-->uiautomator(python版)-->uiautomator2

3.三款框架对比

框架

支持语言

特点

uiautomator

java

谷歌开源，仅支持Android

xiaocong/uiautomator

python

开源，仅支持Android

uiautomator2

python

开源，仅支持Android

二、uiautomator2简介

1.项目组成

  • uiautomator-server：主服务
  • minicap：实现实时屏幕投频，以及实时截图
  • minitouch：用于精确实时控制设备
  • atx-agent：运行在设备上的驻守程序，go开发，用于保活设备上相关的服务
  • weditor：类似于uiautomatorviewer，专门为本项目开发的辅助编辑器

2.工作原理

1）各部分职责

  • Python：编写脚本，向移动设备发起http请求；
  • 移动设备：运行了封装了uiautomator2的http服务，解析python脚本发起的请求，并转化成uiautomator2可识别的代码；

2）运行过程

  1. 移动设备上运行atx-agent守护进程，随后atx-agent启动uiautomator2服务，默认7912端口进行监听；
  2. 在PC上编写python脚本并执行（相当于发送 HTTP 请求到移动设备的 server 端）；
  3. 移动设备通过 WIFI 或 USB 接收到 PC 上发来的 HTTP 请求，执行指定的操作，从而操作移动设备；

三、环境搭建

1.安装uiautomator2


/

pip install uiautomator2
pip install -U weditor  # 安装weditor

2.初始化设备

python -m uiautomator2 init

初始化成功会出现如下提示

当PC或Linux服务器连接了多台adb device的情况下，“python -m uiautomator2 init”默认初始化的是所有设备，若指定设备初始化，则需使用“--serial”参数：

python -m uiautomator2 init --serial $SERIAL  # $SERIAL为手机序列号，可通过adb devices查看

3.init时都干了啥？

执行“python -m uiautomator2 init”命令，会自动往手机上安装一堆东西：

  • app-uiautomator.apk
  • app-uiautomator-test.apk
  • atx-agent
  • minicap
  • minitouch

更多信息详见：https://github.com/openatx/uiautomator2/wiki/Manual-Init

四、基础操作

1.连接设备

uiautomator2提供了3种连接方式

1）通过WiFi连接

import uiautomator2 as u2
d = u2.connect('10.0.0.1') # alias for u2.connect_wifi('10.0.0.1')
print(d.info)

2）通过USB连接

importuiautomator2asu2d=u2.connect('123456f') # alias for u2.connect_usb('123456f')print(d.info)

3）通过ADB WiFi连接

importuiautomator2asu2d=u2.connect_adb_wifi("10.0.0.1:5555")
# 等同于# + Shell: adb connect 10.0.0.1:5555# + Python: u2.connect_usb("10.0.0.1:5555")

2.命令行工具

1）截图

uiautomator2screenshottest.jpg

2）获取当前APP报名及Activity

uiautomator2current

3）卸载应用

uiautomator2uninstall<package-name># 卸载一个包uiautomator2uninstall<package-name-1><package-name-2># 卸载多个包uiautomator2uninstall--all# 全部卸载

4）停止应用

$uiautomator2stopcom.example.app# 停止一个app$uiautomator2stop--all# 停止所有的app

3.元素定位

1）常见定位方式

ui2支持 android 中 UiSelector 类中的所有定位方式，详细可以查看官网：https://developer.android.com/reference/android/support/test/uiautomator/UiSelector，以下仅列出几种常见的定位方式：

定位方式

描述

text

通过文本定位

textMatches

通过文本正则匹配定位

className

通过类名定位

classNameMatches

通过类名正则匹配定位

description

通过desc属性定位

descriptionMatches

通过desc属性正则匹配定位

resourceId

通过resourceId定位

resourceIdMatches

通过resourceId正则匹配定位

2）子元素定位及兄弟元素定位

① 子元素定位-child
#查找类名为android.widget.ListView下的Bluetooth元素d(className="android.widget.ListView").child(text="Bluetooth")
# 下面这两种方式定位有点不准确，不建议使用d(className="android.widget.ListView")\
.child_by_text("Bluetooth",allow_scroll_search=True)
d(className="android.widget.ListView").child_by_description("Bluetooth")
② 兄弟元素定位-sibiling
#查找与google同一级别，类名为android.widget.ImageView的元素d(text="Google").sibling(className="android.widget.ImageView")
③ 链式调用
d(className="android.widget.ListView", resourceId="android:id/list") \
  .child_by_text("Wi‑Fi", className="android.widget.LinearLayout") \
  .child(className="android.widget.Switch") \
  .click()

3）相对定位

d(A).left(B),# 选择A左边的Bd(A).right(B),# 选择A右边的Bd(A).up(B), #选择A上边的Bd(A).down(B),# 选择A下边的B#选择 WIFI 右边的开关按钮d(text='Wi‑Fi').right(resourceId='android:id/widget_frame')

4） Xpath定位

Java uiautoamtor中默认不支持xpath，这是属于ui2的扩展功能，速度会相比其它定位方式慢一些。在xpath定位中，ui2中的description 定位需要替换为content-desc，resourceId 需要替换为resource-id

# 只会返回一个元素，如果找不到元素，则会报XPathElementNotFoundError错误# 如果找到多个元素，默认会返回第0个d.xpath('//*[@resource-id="com.android.launcher3:id/icon"]')
# 如果返回的元素有多个，需要使用all()方法返回列表# 使用all方法，当未找到元素时，不会报错，会返回一个空列表d.xpath('//*[@resource-id="com.android.launcher3:id/icon"]').all()

4.元素常用API

方法

描述

返回值

备注

exists()

判断元素是否存在

True,Flase

@property

info()

返回元素的所有信息

字典

@property

get_text()

返回元素文本

字符串

set_text(text)

设置元素文本

None

clear_text()

清空元素文本

None

center()

返回元素的中心点位置

(x,y)

基于整个屏幕的点

send_keys()

发送文本

用法示例：

d(test="Settings").existsd.exists(text='Wi‑Fi',timeout=5)

5.设备交互

1）单击/双击

d(text='Settings').click()  # 单击d.double_click(x, y)
d.double_click(x, y, 0.1) # 双击默认时间间隔0.1s

2）长按

d(text='Settings').longclick()  # 长按

3）滑动

# "left", "right", "up", "down"d(text="Settings").swipe("up", steps=20)  # 元素向上滑动，步长20d(text="Settings").swipe("down", steps=20)  # 元素向下滑动d(text="Settings").swipe("left", steps=20)  # 元素向左滑动d(text="Settings").swipe("right", steps=20)  # 元素向右滑动

4）拖动

d(text="Settings").drag_to(text="Clock", duration=0.25)  # 拖动到某个元素，时长0.25秒d(text="Settings").drag_to(877,733)  # 拖动到屏幕某个坐标点，duration时长默认0.5秒

5）双指操作（元素放大/缩小）

d(text="Settings").pinch_in()  # 缩小d(text="Settings").pinch_out()  # 放大

6）等待元素出现/消失

d(text="Settings").wait(timeout=3.0)  # 等待元素出现d(text='Settings').wait_gone(timeout=20)  # 等待元素消失，返回True False,timout默认为全局设置的等待时间

7）屏幕滚动

# 垂直滚动到页面顶部/横向滚动到最左侧d(scrollable=True).scroll.toBeginning()
d(scrollable=True).scroll.horiz.toBeginning()
# 垂直滚动到页面最底部/横向滚动到最右侧d(scrollable=True).scroll.toEnd(）d(scrollable=True).scroll.horiz.toEnd()
# 垂直向后滚动到指定位置/横向向右滚动到指定位置d(scrollable=True).scroll.to(description="指定位置")
d(scrollable=True).scroll.horiz.to(description="指定位置")
# 垂直向前滚动（横向同理）d(scrollable=True).scroll.forward()
# 垂直向前滚动到指定位置（横向同理）d(scrollable=True).scroll.forward.to(description="指定位置")
# 滚动直到System元素出现d(scrollable=True).scroll.to(text="System")

8）文本框操作

d.send_keys("test")
d.clear_text()  # 清空输入框

9）toast操作

# 获取toast,当没有找到toast消息时，返回default内容d.toast.get_message(timout=5,default='no toast')
# 清空toast缓存d.toast.reset()

10）监控操作

# 移除ANR的监控d.watcher.remove("ANR")
# 移除所有的监控d.watcher.remove()
# 开始后台监控d.watcher.start()
d.watcher.start(2.0) # 默认监控间隔2.0s# 强制运行所有监控d.watcher.run()
# 停止监控d.watcher.stop()
# 停止并移除所有的监控，常用于初始化d.watcher.reset()

更多api详见：https://github.com/openatx/uiautomator2

五、weditor元素定位

1.启动weditor服务

python-mweditor

2.访问weditor

默认端口17310，访问地址：http://localhost:17310/，手机连接PC（确保已开启USB调试模式），点击Connect连接设备，当Connect图标变为绿色表示连接成功。

3.界面调试

weditor提供了所操作即所得式的元素定位方式，当双击屏幕上的图标或按钮，weditor界面右侧的Coding框会同步展现元素操作的代码，同时手机界面也会相应同步切换页面。


文章标签：
Java
Python
Go
Android开发
测试技术
监控
Linux
API
开发者
关键词：
自动化框架
测试框架
APP测试
自动化测试app
APP自动化
大刚测试开发实战
目录
相关文章
游客uul6wusao3sds
|
6天前
|
Web App开发 JavaScript 前端开发
深入理解自动化测试框架Selenium的设计与实现
【4月更文挑战第20天】 在软件测试领域，自动化测试已成为提升测试效率和确保产品质量的关键手段。Selenium作为一款广泛使用的开源自动化测试框架，其设计精巧且功能强大，为Web应用提供了一种灵活、高效的测试解决方案。本文将深入探讨Selenium的核心架构与实现细节，解析其如何通过模拟用户操作来执行测试用例，以及它如何适应不断变化的Web技术标准。通过对Selenium内部机制的剖析，旨在帮助测试工程师更好地掌握该工具，并在测试实践中发挥其最大效能。
游客uul6wusao3sds
23 8
阿文没烦恼
|
8天前
|
监控 测试技术 数据安全/隐私保护
如何将代理IP集成到自动化测试框架中？
如何将代理IP集成到自动化测试框架中？
阿文没烦恼
10 0
TesterMuller
|
8天前
|
XML 数据格式 Python
App测试中，强制等待和隐式等待谁更强？
本文介绍了在自动化脚本中添加等待以确保与应用程序同步的重要性。由于应用响应时间的不确定性，适当等待能防止脚本在操作未完成前继续执行，提高测试稳定性。等待包括强制等待（如`time.sleep()`）、隐式等待（全局设置查找元素的等待时间）和显式等待（根据预期条件等待）。示例代码展示了如何在Python的Appium测试中应用这些等待策略，以优化脚本的可靠性和与应用的同步。
TesterMuller
21 0
游客799
|
10天前
|
敏捷开发 监控 前端开发
深入理解自动化测试框架Selenium的架构与实践
【4月更文挑战第16天】 在现代软件开发过程中，自动化测试已成为确保产品质量和加快迭代速度的关键手段。Selenium作为一种广泛使用的自动化测试工具，其开源、跨平台的特性使得它成为业界的首选之一。本文旨在剖析Selenium的核心架构，并结合实际案例探讨其在复杂Web应用测试中的高效实践方法。通过详细解读Selenium组件间的交互机制以及如何优化测试脚本，我们希望为读者提供深入理解Selenium并有效运用于日常测试工作的参考。
游客799
15 1
肥猪肥猪-17824
|
11天前
|
自然语言处理 测试技术 API
深入理解自动化测试框架Selenium的设计理念与实践
【4月更文挑战第15天】 在现代软件开发过程中，自动化测试已成为确保产品质量和加速迭代的关键手段。Selenium作为一种广泛使用的自动化测试框架，提供了对多种浏览器和平台的支持，极大地促进了Web应用的功能测试。本文旨在剖析Selenium的核心设计理念，探讨其在实际项目中的应用，并指出常见的误区及最佳实践，以期帮助测试工程师更高效地利用Selenium进行测试工作。
肥猪肥猪-17824
26 12
技术混子
|
12天前
|
监控 测试技术 API
深入理解自动化测试框架Selenium的设计与实现
【4月更文挑战第14天】在软件开发过程中，自动化测试是确保代码质量、减少人工重复劳动的关键步骤。Selenium作为一款广泛使用的自动化测试工具，提供了对多种浏览器和操作系统的支持。本文将探讨Selenium的核心组件及其架构设计，分析其如何通过WebDriver与浏览器交互，以及它如何支持多种编程语言进行脚本编写。同时，我们还将讨论Selenium Grid的作用以及它如何实现并行测试，以缩短测试周期并提高测试效率。
技术混子
178 59
学编程的小程
|
14天前
|
Web App开发 前端开发 Java
框架分析（11）-测试框架
框架分析（11）-测试框架
学编程的小程
30 0
游客qf4jmczx4xu2y12121
|
28天前
|
敏捷开发 设计模式 监控
深入理解自动化测试框架的设计原则
在软件开发的复杂多变环境中，自动化测试已成为确保产品质量和加速市场交付的关键步骤。本文将探讨自动化测试框架的设计原则，包括模块化、可扩展性、易用性和可靠性，旨在为软件测试工程师提供构建高效、健壮且易于维护的自动化测试系统的指导。通过分析设计模式的应用，我们将了解如何减少代码冗余，提高测试覆盖率，并适应快速变化的技术要求。
游客qf4jmczx4xu2y12121
17 0
游客moiomvrp3vyac2
|
29天前
|
前端开发 IDE JavaScript
深入理解自动化测试框架Selenium的设计与实现
本文旨在探讨开源自动化测试框架Selenium的核心设计及其实现机制。通过分析其架构、组件和工作原理，揭示Selenium如何有效地支持跨浏览器、跨平台的自动化Web测试。文中不仅介绍了Selenium的主要功能模块，还详细讨论了其面临的挑战及应对策略，为读者提供了深入了解和使用Selenium的理论基础和实践指导。
游客moiomvrp3vyac2
12 1
TesterMuller
|
30天前
|
XML 测试技术 数据格式
解决 App 自动化测试的常见痛点
在App自动化测试中，常见挑战包括启动加载慢和弹框干扰。为处理弹框，可以创建一个黑名单列表，遍历并点击消除。使用`handleAlertByPageSource()`方法结合`getPageSource()`判断弹框元素在当前页面的存在性，提高效率。对于首页加载延迟，使用显示等待特定元素如`user_profile_container`，但需注意弹框可能阻止元素定位。因此，结合PageSource判断首页元素和弹框，确保加载完成判断的准确性。通过这样的优化，能更有效地处理自动化测试中的中断问题。
TesterMuller
19 1

热门文章

最新文章

  • 1
    uni-app使用v-html输出富文本图片溢出解决
  • 2
    Error:Execution failed for task ':app:javaPreCompileDebug'. > Annotation processors must be explicit
  • 3
    云擎技术---分析工信部APP备案的“传闻”
  • 4
    App测试中，强制等待和隐式等待谁更强？
  • 5
    安卓即时应用(Instant Apps)开发指南
  • 6
    构建高效自动化运维体系的五大关键步骤
  • 7
    构建高效自动化运维体系：基于Docker和Kubernetes的最佳实践
  • 8
    深入理解 uni-app 页面生命周期（三）：onHide vs onUnload
  • 9
    【Hbuilder】Hbuilder 插件[App]云打包安装失败--已解决
  • 10
    解决 App 自动化测试的常见痛点
  • 1
    Apache Flink官方网站提供了关于如何使用Docker进行Flink CDC测试的文档
    143
  • 2
    Kafka【付诸实践 03】Offset Explorer Kafka 的终极 UI 工具安装+简单上手+关键特性测试（一篇学会使用 Offset Explorer）
    189
  • 3
    P2P网络下分布式文件共享场景的测试
    33
  • 4
    Jest测试核心
    10
  • 5
    探索自动化测试在持续集成环境中的关键角色
    13
  • 6
    软件质量测试笔记-合工大
    102
  • 7
    模拟试错（STE）法让7B大模型测试超GPT-4
    32
  • 8
    《手把手教你》系列基础篇（五）-java+ selenium自动化测试- 创建首个自动化脚本（详细教程）
    42
  • 9
    Flink CDC产品常见问题之使用3.0测试mysql到starrocks启动报错如何解决
    68
  • 10
    DataWorks报错问题之ecs自建数据库连通性测试报错如何解决
    17

    • 相关课程

    更多
  • MSE微服务测试最佳实践 - 自动化回归
  • 互联网安全-移动APP漏洞风险与解决方案
  • 开源Android容器化框架Atlas开发者指南
  • Python Web开发基础
  • Cloud Toolkit 开发部署效率提升神器
  • Python Web 框架 Django 快速入门

    • 相关电子书

    更多
  • 女性移动App安全攻防战
  • 汇聚云计算的生态核能——云市场，云上APP Store
  • 千万级用户直播App——服务端架构设计和思考

    • 相关实验场景

    更多
  • 搭建Java Web开发环境
  • 快速上手并跑通AnalyticDB PostgreSQL版TPC-H测试
  • 基于函数计算快速搭建Zblog等传统应用框架
  • 基于Mappings自动化配置yum源
  • 星轨-钉钉APP分发实训
    • 下一篇
    部署LAMP环境（Alibaba Cloud Linux 3）