UiAutomator2自动化测试环境搭建

UiAutomator2自动化测试环境搭建指南

最新推荐文章于 2025-05-31 18:57:24 发布

原创

最新推荐文章于 2025-05-31 18:57:24 发布 · 1.2w 阅读

18 ·

CC 4.0 BY-SA版权

文章标签：

#自动化测试

本文详细介绍了如何搭建UiAutomator2自动化测试环境，包括前期准备、新建Android Studio工程，以及配置UiAutomator2环境的具体步骤，如导入jar包、设置library和编写测试代码。最后，文章提到了运行测试前的设备准备和运行流程。

一、前期准备

 在此之前先将Android studio 环境安装搭建好，搭建好后接下来需要uiautomator2 jar包，这里就为大家提供了,
 可以自行到这里下载 http://pan.baidu.com/s/1pJX6kiB  解压后里面文件有一下内容

这里写图片描述

这些jar包是UiAutomator2的需要用到的jar包

二、开始建工程

打开Android Studio（一下统称AS），File——》new——》new project 如图

这里写图片描述

出现以下界面

这里写图片描述

根据自己需求修改参数，下一步

这里写图片描述

下一步

这里写图片描述

下一步

这里写图片描述

完成

这里写图片描述

好啦工程就弄

最低0.47元/天解锁文章

200万优质内容无限畅学

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

LangSand

关注关注

2
点赞
踩
18

收藏

觉得还不错? 一键收藏
3
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

正厚软件|UIAutomator2的使用教程(上)

正小厚的家

11-15

877

一、简介 uiautomator2是一个python库，用于Android的UI自动化测试，其底层基于Google uiautomator，Google提供的uiautomator库可以获取屏幕上任意一个APP的任意一个控件属性，并对其进行任意操作。GitHub地址：https://github.com/openatx/uiautomator2二、支持平台及语言 python-uiautomator2封装了谷歌自带的uiautomator2测试框架，提供便利的python接口。他允许测试人员直接在PC上

02 Python+UIAutoMator2 app自动化【框架搭建】

BenZ_X的专栏

07-21

1235

01 开发环境安装 jdk安装（version "1.8.0_361"） python安装（Python37） python编辑器安装（PyCharm2021） 02 运行环境安装 adb安装（Android Debug Bridge version 1.0.41 Version 34.0.3-10161052） uiautomator2安装 weditor安装模拟器安装（逍遥或者夜神）

3 条评论您还未登录，请先登录后发表或查看评论

UIAutomator2环境配置

天地沧海

06-27

1158

http://baijiahao.baidu.com/s?id=1569723579046674&wfr=spider&for=pc&qq-pf-to=pcqq.group

uiautomator2

04-22

提示: Command 'D:\Android\android-sdk-windows\build-tools\23.0.1\aapt.exe dump badging ==D:\nodejs\node_modules\_appium-uiautomator2-driver\@0.4.0\@appium-uiautomator2-driver\uiautomator2\appium-uiautomator2-server-v0.1.6.apk==' exited with code 1 有了这个工具就可以解决

UIAutomator2 配置

qq_41236493的博客

03-28

296

步骤一：安装 pip install --pre -U uiautomator2 步骤二：手机通过usb插在电脑上(需要开启开发者模式，勾选USB调试与安装) 百度查询自己手机机型开启开发者模式步骤三：配置adb 从谷歌官网下载Android Platform Tools https://developer.android.com/studio/releases/platform-tool...

uiautomator2 安装使用教程

qq_42778518的博客

09-15

2832

uiautomator2 安装使用教程

uiautomator2+weditor：UI自动化测试环境搭建【安卓应用所需安装的服务】

10-25

整个UI自动化测试环境搭建完成后，我们就可以开始编写测试用例了。通过编写测试用例，我们可以模拟用户的行为，进行界面的自动化操作，并在操作过程中检查应用的状态和行为是否符合预期。自动化测试能够极大提高测试...

uiautomator2+pytest+allure进行Android的UI自动化测试

06-06

使用uiautomator2+pytest+allure进行Android的UI自动化测试测试携程旅行App，首页-机票-机票搜索模块简介使用uiautomator2+pytest+allure进行Android的UI自动化测试环境搭建 pytest框架 pip install pytest ...

uiautomator2-快速入门app自动化测试-从配置环境到测试

cs77711的博客

06-15

596

点击获取SDK安装链接，电脑什么系统就安装对应的tools 配置环境变量：环境变量–系统变量（下面那个，别点成用户变量了）–Path-- 写入你的adb 的位置，注意分号检查adb是否可以使用，在cmd里面输入adb 回车【记得配置好之后重新打开cmd查询】有一点要强调，目前如果只用电脑上的模拟机，则配置ATX环境只需要在Pycharm里面安装好atx、uiautomator2，再运行代码就可以，就方法二图片，运行代码之后模拟机就自动安装ATX了。如果是需要使用真机，初始化一定要做对，要在被测机上

Uiautomator2教程

Mwyldnje2003的博客

01-25

1546

参考：uiautomator2 库中文手册，非常详细

UiAutomator2基本配置与使用

dzjwwm的博客

04-27

954

将platform-tools的路径添加到环境变量中。，如果出现以下内容，则表示安装成功。

Android APP自动化工具uiautomator2超详细环境搭建+例子演示

weixin_49098230的博客

03-27

5218

UiAutomator是Google提供的安卓自动化测试Java库，功能很强，但测试脚本只能使用Java语言，uiautomator2是uiautomator的升级版，uiautomator2将uiautomator中的接口封装成了Python库，因此它支持的语言为Python。

python自动化测试之Uiautomato2入门教程

热门推荐

qq_43540385的博客

10-11

1万+

uiautomator2详细使用方法

uiautomator2快速入门app自动化测试教程

汪学友的博客

11-22

6498

本文章需要会 python 基础语法，课程目标是熟练使用 uiautomator2 库进行 android 自动化测试。

uiautomator2.0的配置的两种方法

qq_37217804的博客

09-20

4011

dependencies { compile fileTree(include: ['*.jar'], dir: 'libs') androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', { exclude group: 'com.android.support',

UiAutomator2自动化测试框架详细介绍

04-23

<think>好的，我需要为用户提供关于UiAutomator2自动化测试框架的详细介绍和文档指南。首先，我需要回顾之前的对话，确保内容连贯。用户之前询问了Android Studio，现在转向UiAutomator2，所以可能需要强调与Android开发工具的集成。接下来，查看用户提供的引用内容。引用3和4提到了uiautomator2的Python脚本支持、异步操作、异常处理，以及安装步骤。引用2提到了Android设备层的测试框架，如UIAutomator和UIAutomator2。需要整合这些信息，确保覆盖核心功能、安装配置、基本使用、高级特性、与Android Studio的集成以及最佳实践。用户需要详细文档和使用指南，因此结构要清晰，分章节说明。要包含代码示例，比如Python脚本，以及环境配置步骤，比如安装命令和初始化。同时，可能需要比较UiAutomator2与其他框架（如Appium）的区别，突出其优势，比如直接访问UI元素、支持Python等。注意用户可能关心实际应用场景，比如持续集成、复杂手势测试，因此需要相关案例和集成方法。此外，常见问题解答部分可以帮助用户解决典型错误，如设备连接问题或元素定位失败。需要确保所有技术细节准确，比如依赖库版本、命令的正确性。同时，链接到官方文档和GitHub仓库，方便用户进一步查阅。最后，生成相关问题，帮助用户深入探索，比如性能优化或与其他工具的比较。</think>### UiAutomator2 自动化测试框架深度解析 UiAutomator2 是由 OpenATX 维护的 Android UI 自动化测试框架，支持通过 Python 脚本实现设备交互。以下从核心架构到实战应用进行全面说明，并提供关键代码示例与调试技巧。 --- #### 一、框架核心特性 1. **跨进程操作** - 直接访问任意应用的 UI 元素，无需注入代码 - 通过 `Android Debug Bridge (ADB)` 与设备通信 $$ \text{测试机} \xrightarrow{\text{Python脚本}} \text{ADB} \xrightarrow{\text{JSON-RPC}} \text{设备端服务} $$ 2. **多语言支持** - 原生支持 Python 编写测试用例 - 集成其他语言（如 Java）需通过 HTTP 接口调用[^2] 3. **异步执行机制** ```python # 异步点击示例 import uiautomator2 as u2 d = u2.connect() d.click.async_click(0.5, 0.5) # 非阻塞操作 ``` - 提升长流程测试执行效率 4. **元素定位体系** | 定位方式 | 语法示例 | |------------------|------------------------------| | 资源ID | `d(resourceId="com.example:id/btn")` | | 文本匹配 | `d(text="Submit")` | | 组合选择器 | `d(className="Button", instance=2)` | --- #### 二、环境搭建与配置 1. **设备端依赖安装** ```bash # 初始化设备服务（自动安装atx-agent等） python -m uiautomator2 init ``` - 依赖组件： - `uiautomator-server.apk`：UI 操作服务 - `minicap/minitouch`：屏幕流与触控支持[^4] 2. **开发环境配置** ```bash # 安装Python库（推荐使用虚拟环境） pip install uiautomator2 weditor ``` - 辅助工具： - `Weditor`：可视化元素选择器（启动命令：`weditor --adb`） --- #### 三、基础操作与脚本编写 1. **设备连接管理** ```python # 通过序列号连接指定设备 d = u2.connect("emulator-5554") # 或自动选择首个可用设备 d = u2.connect() ``` 2. **常见交互操作** ```python # 点击操作链 d(text="Settings").click() d.xpath('//*[@content-desc="Network"]').click(timeout=10) # 滑动与拖拽 d.swipe(0.5, 0.8, 0.5, 0.2, duration=0.5) # 从底部滑动到顶部 d.drag(100, 200, 400, 500, duration=0.1) # 模拟拖拽动作 # 文本输入 d(resourceId="com.android.dialer:id/digits").set_text("13800138000") ``` 3. **断言与验证** ```python assert d(text="Welcome").exists(timeout=5), "登录失败" print(d.info) # 获取设备当前状态（屏幕尺寸、电量等） ``` --- #### 四、高级功能与调试技巧 1. **图像识别集成** ```python # 基于OpenCV的图像匹配（需安装opencv-python） d.image.match("screenshot.png").click() ``` - 适用场景：验证界面截图或非标准控件 2. **性能监控** ```python # 获取CPU/Memory数据 perf = d.app_perf("com.android.settings") print(f"CPU使用率: {perf['cpu']}%, 内存占用: {perf['memory']}MB") ``` 3. **异常处理机制** ```python try: d(text="Delete").click() except u2.UiAutomationError as e: d.screenshot("error.png") # 自动保存错误截图 raise e ``` --- #### 五、与 Android Studio 的集成方案 1. **单元测试整合** ```gradle // build.gradle 配置测试依赖 androidTestImplementation 'com.github.openatx:uiautomator2:2.16.0' ``` - 在 `AndroidTest` 目录中编写 Java 测试用例 2. **持续集成流程** ```yaml # GitHub Actions 配置示例 - name: Run UI Tests run: | adb connect ${{ secrets.DEVICE_IP }} pytest tests/ui_automation/ ``` --- #### 六、最佳实践与常见问题 1. **元素定位优化** - 优先使用 `resourceId` 而非 `text`（防止多语言问题） - 对动态元素使用 `XPath` 或 `until` 等待策略： ```python d(text="Loading").until.gone(timeout=20) # 等待加载完成 ``` 2. **常见错误排查** | 错误现象 | 解决方案 | |--------------------------|------------------------------| | `UiAutomation not connected` | 重启设备端服务：`adb shell am instrument -w -r -e debug false -e class com.github.uiautomator.stub.Stub com.github.uiautomator.test/androidx.test.runner.AndroidJUnitRunner` | | 元素定位超时 | 检查是否启用开发者选项中的「指针位置」辅助调试 | --- #### 官方文档与扩展资源 - [GitHub 仓库](https://github.com/openatx/uiautomator2) - [API 文档](https://uiautomator2.readthedocs.io/) - 调试工具推荐： - **Scrcpy**：实时投屏与触控操作 - **STF**：多设备集群管理