appium入坑必备--详解uiautomator2，让你摆脱usb_appium uiautomator2

最后

不知道你们用的什么环境，我一般都是用的Python3.6环境和pycharm解释器，没有软件，或者没有资料，没人解答问题，都可以免费领取（包括今天的代码），过几天我还会做个视频教程出来，有需要也可以领取~

给大家准备的学习资料包括但不限于：

Python 环境、pycharm编辑器/永久激活/翻译插件

python 零基础视频教程

Python 界面开发实战教程

Python 爬虫实战教程

Python 数据分析实战教程

python 游戏开发实战教程

Python 电子书100本

Python 学习路线规划

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化学习资料的朋友，可以戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

2. 测试脚本要打包成jar或者apk包上传到设备上才能运

python-uiautomator2封装了谷歌自带的uiautomator测试框架，提供便利的python接口。他允许测 试人员直接在PC上编写Python的测试代码，操作手机应用，完成自动化，大大提高了自动化代码 编写的效率。

python-uiautomator2是一个自动化测试开源工具，仅支持Android平台的原生应用测试。

原理： 在手机上运行了一个http rpc服务，将uiautomator中的功能开放出来，然后再将这些http接口封 装成Python库

Uiautomator2

环境搭建

1.安装adb

此处早已经安装了，讲adb命令及monkey的时候就有讲过，Android-SDK自带

2. 安装uiautomator2，此处有三种方式，推荐方式二、三，直接cmd命令输入即可

方式一： pip install --upgrade --pre uiautomator2

方式二：git clone https://github.com/openatx/uiautomator2 pip install -e uiautomator2

方式三：离线安装 python安装目录-lib-sit-packages,将这个目录打包

3.设备初始化，此处有个便捷的方式方法，直接建立连接，u2.connect(‘127.0.0.1:62001’)，并跑一次程序，真机或模拟器上就会自动安装了，此处详细代码看后续展示。

首先设备连接到PC，并能够adb devices发现该设备 命令： python -m uiautomator2 init(从github下载atx-agent文件，并推送到手机。在手机上安装包名为 com.github.uiautomator的apk) 如果有多台设备，指定设备初始化加参数：–serial 如 python3 -m uiautomator2 --serial bff1234

常用操作

1.devices.click_post_delay=1 #全局设置，每次操作休眠1s

2.uninstall： 卸载uiautomator2 uninstall # 卸载一个包

3.d.screen_on() /d.screen_off() 屏幕关闭的情况下点亮一次/锁屏

4.d.press(“home”) # press the home key, with key name 按键主页键

5.d.press(“back”) # press the back key, with key name 按键返回键

6.d.app_info(“com.examples.demo”)  app信息

7.d.app_start(“com.example.hello_world” , “.MainActivity”) # 通过指定main activity的方式启动应用，等价于调用am start -n com.example.hello_world/.MainActivity

8.d.implicitly_wait(10.0) ：设置元素查找等待时间（默认20s）全局

9.d.app_stop(“com.example.hello_world”)  停止运行app

10. d.app_clear(‘com.example.hello_world’)  清理app

11.d.app_stop_all() 关闭所有应用

连接设备

python-uiautomator2连接手机的方式有两种，一种是通过WIFI，另外一种是通过USB。两种方法各 有优缺点。

Wifi连接

手机获取到手机的IP，并确保电脑可以PING通手机。手机的IP可以在设置-WIFI设置里面获取到。 比如手机的IP是192.168.1.111，连接设备的代码为

import uiautomator2 as u2
d = u2.connect('192.168.1.111')

USB连接

手机的序列号可以通过adb devices获取到，假设序列号是emulator-5554，连接代码为

import uiautomator2 as u2 
d = u2.connect_usb('emulator-5554')

此处不管是手机还是模拟器，查询到序列号填入即可

定位工具

安装weditor元素定位工具 前置条件：设备需要初始化init （类似uiautomatorview,编辑器能够提供辅助编写脚本，查看组件信息，调试代码等功能。）

pip install --pre wedi

安装好了之后运行命令，会得到一个网页窗口：

python -m weditor

输入设备号后，点击connect进行连接，成功后后面会显示一棵绿草，此时刷新一个界面Dump Hierarchy即可，如果你想实时刷新界面就打开实时按钮即可。

定位元素

启动应用

# 默认的这种方法是先通过atx-agent解析apk包的mainActivity，然后调用am start -n $package/$activity启动

import uiautomator2 as u2

devices = u2.connect('emulator-5554')
print(devices.info)
d.app_start("com.netease.cloudmusic")
# 启动应用并跳转到对应的界面
d.app_start("com.netease.cloudmusic" , "com.netease.cloudmusic.activity.MainActivity")

此处打印设备信息的时候，如环境搭建初始化所说，这里运行之后设备端会自行安装atx

停止应用

import uiautomator2 as u2

devices = u2.connect('emulator-5554')
print(devices.info)
d.app_start("com.netease.cloudmusic")
# 启动应用并跳转到对应的界面
d.app_start("com.netease.cloudmusic" , "com.netease.cloudmusic.activity.MainActivity")
# 停止运行
d.app_stop("com.netease.cloudmusic")

查包名

此处介绍一个uiautomator2独有了查看包名及活动界面信息的命令 uiautomator2 current

代码量少，且容易记住，也便于一眼望去就能十分清楚的知道包名及界面信息。

定位方式

ResourceId定位: d(resourceId= “com.smartisanos.clock:id/text_stopwatch”).click()

Text定位 d(text= “秒表”).click()

Description定位 d(description= “…”).click()

ClassName定位 d(className= “android.widget.TextView”).click()

xpath定位d.xpath(‘//*[@text=“每日推荐”]’).click()

坐标定位d.click(x, y)

它的定位方式还是比较的特殊的，双击任何一处，WEditor界面会自动给出定位代码。

ResourceId定位

import uiautomator2 as u2
from time import sleep

devices = u2.connect('emulator-5554')
# 打印设备信息
print(devices.info)
# 定位每日推荐
devices(resourceId='com.netease.cloudmusic:id/portalTitle').click()
sleep(2)
# 关闭APP
devices.app_stop('com.netease.cloudmusic')

Text定位

import uiautomator2 as u2

devices = u2.connect('emulator-5554')
# 打印设备信息
print(devices.info)
# 每次操作间隔/休眠3S
devices.click_post_delay=3
# 打开APP
devices.app_start('com.netease.cloudmusic')
# 定位每日推荐
devices(text="每日推荐").click()
# 关闭APP
devices.app_stop('com.netease.cloudmusic')

Description定位

import uiautomator2 as u2

devices = u2.connect('emulator-5554')
# 打印设备信息
print(devices.info)
# 每次操作间隔/休眠3S
devices.click_post_delay=3
# 定位每日推荐
devices(description='抽屉菜单').click()
devices.app_stop('com.netease.cloudmusic')

ClassName定位

这里我找了半天都没找到单独的className元素，所以这里就暂不举例，我们下文举例多个元素怎么使用classname定位再此介绍。

xpath定位

import uiautomator2 as u2

devices = u2.connect('emulator-5554')
# 打印设备信息
print(devices.info)
# 每次操作间隔/休眠3S
devices.click_post_delay=3
# 打开app
# devices.app_start('com.netease.cloudmusic')
# 定位每日推荐
devices.xpath('//*[@text="每日推荐"]').click()
devices.app_stop('com.netease.cloudmusic')

坐标定位

import uiautomator2 as u2
from time import sleep

devices = u2.connect('emulator-5554')
# 打印设备信息
print(devices.info)
# 每次操作间隔/休眠3S
devices.click_post_delay=3
# 打开app
# devices.app_start('com.netease.cloudmusic')
# 定位每日推荐
devices.click(0.078, 0.092)
sleep(5)
devices.app_stop('com.netease.cloudmusic')

重复元素定位

这里就介绍一下上文没有介绍的classname定位，如图所示，这些元素名都叫android.widget.TextView，那么怎么定位呢。

import uiautomator2 as u2
from time import sleep

devices = u2.connect('emulator-5554')
# 打印设备信息
print(devices.info)
# 每次操作间隔/休眠3S
devices.click_post_delay=3
# 打开app
# devices.app_start('com.netease.cloudmusic')
# 定位每日推荐
devices(className='android.widget.TextView')[2].click()
sleep(5)
devices.app_stop('com.netease.cloudmusic')

至于此方法个人觉得还是比较麻烦的，毕竟需要自己再页面上找相同的元素，自上而下的索引。这里只介绍了className其他方式方法皆可这样。学会举一反三。

截图

import uiautomator2 as u2
from time import sleep

devices = u2.connect('emulator-5554')
# 打印设备信息
print(devices.info)
# 每次操作间隔/休眠3S
devices.click_post_delay=3
# 打开app
# devices.app_start('com.netease.cloudmusic')
# 定位每日推荐
devices(className='android.widget.TextView')[2].click()
sleep(5)
# 截图
devices.screenshot('music.jpg')
devices.app_stop('com.netease.cloudmusic')

默认保存在当前文件下。

文件推送与拉取

# 推送


### 最后

> **🍅 硬核资料**：关注即可领取PPT模板、简历模板、行业经典书籍PDF。  
> **🍅 技术互助**：技术群大佬指点迷津，你的问题可能不是问题，求资源在群里喊一声。  
> **🍅 面试题库**：由技术群里的小伙伴们共同投稿，热乎的大厂面试真题，持续更新中。  
> **🍅 知识体系**：含编程语言、算法、大数据生态圈组件（Mysql、Hive、Spark、Flink）、数据仓库、Python、前端等等。




**网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。**

**[需要这份系统化学习资料的朋友，可以戳这里获取](https://bbs.csdn.net/forums/4304bb5a486d4c3ab8389e65ecb71ac0)**

**一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！**