uiautomator2使用方法

一.设备连接

1.usb单设备连接

复制代码
d = u2.connect()

2.usb多设备连接

复制代码
d = u2.connect("90bf8faf")  # 多台设备填写device即可

3.wifi连接

复制代码
d = u2.connect("ip:proxy")  # wifi连接设备

adb使用wifi连接设备:https://www.cnblogs.com/lihongtaoya/p/17553171.html

二.使用操作

1.点击

复制代码
#  click点击
d(description="点按两次并按住可长按进入多选模式").click()  # 也可更加某点就行点击d.click(0.1,0.1)
# 单击直到元素消失,点击间隔1s,maxretry超时时长
d(description="点按两次并按住可长按进入多选模式").click_gone(maxretry=5, interval=1)

2.长按

复制代码
# 长按long_click
d(description="点按两次并按住可长按进入多选模式").long_click()

3.文本

复制代码
# 文本
d.send_keys("1234")  # 光标停留在输入框后直接sendkeys,自动切换fastinputime输入法
d.clear_text()  # 光标停留在输入框清空内容

4.拖拽

1)元素到元素拖拽

复制代码
# 元素到元素拖拽drag_to
d(text="SecoClient").drag_to(text="哔哩哔哩", duration=0.25)  # 将元素SecoClient拖到"哔哩哔哩"的位置,时间0.25s

2)元素到坐标拖拽

复制代码
# 元素到坐标的拖拽 drag_to
d(text="SecoClient").drag_to(0.603, 0.587, duration=0.25)

3)坐标到坐标拖拽

复制代码
# 两个坐标之间拖拽drag
d.drag(x1,y1,x2,y2)

5.滑动

1)元素滚动

复制代码
# 元素滑动"left", "right", "up", "down" 左右上下,一个步长5ms,20个step是100ms
d(text="SecoClient").swipe("up", steps=20)  # 将元素向上拖拽,时长100ms

2)屏幕滚动

复制代码
# 屏幕滑动  
x, y = d.window_size()  # 获取屏幕分辨率
x1 = x * 0.1
y1 = y * 0.3
y2 = y * 0.6
d.swipe(x1, y1, x1, y2)  # 手势向下滑,从竖屏30%的地方滑到60%的位置
d.swipe(x*0.9, y*0.1, x*0.1, y*0.1)  # 向右滑,从横屏90%的地方滑到10%的位置

也可直接操作滑动

复制代码
# 直接滑动  "left", "right", "up", "down" 左右上下
d.swipe_ext("left")

3)界面滚动

滚动类型:horiz 为水平 vert 为垂直

滚动方向:forward 向前 , backward 向后 , toBeginning 滚动至开始 , toEnd 滚动至最后 ,to 滚动直接某个元素出现

复制代码
# 界面滚动(界面是否可以滚动)  不太好用
d(scrollable=True).scroll.vert.toBeginning()  # 垂直滚动到页面顶部(不填vert,默认就是垂直)
d(scrollable=True).scroll.vert.toEnd()  # 垂直滚动到页面底部
d(scrollable=True).scroll.horiz.toEnd()  # 水平滚动置末尾,即最右侧
d(scrollable=True).scroll.horiz.toBeginning()  # 水平滚动置开头,即最左侧
d(scrollable=True).scroll.horiz.forward()  # 水平向前滚动一下
d(scrollable=True).scroll.horiz.backward()  # 水平向后滚动一下
d(scrollable=True).scroll.vert.forward()  # 垂直向下滚动一下
d(scrollable=True).scroll.vert.backward()  # 垂直向上滚动一下

滚动置某一个元素停下来

复制代码
# 滚动置某个元素停下
d(scrollable=True).scroll.vert.backward.to(resourceId="id/title", text="《系列》电影")  # 水平向上滚动到指定元素停下,向上找不到元素会往下滚动
d(scrollable=True).scroll.vert.toBeginning.to(text="SDK")  # 垂直向上到指定元素停下,向上到顶部找不到元素会往下滚动

4)连续滚动

d.touch.down(x,y) 按住某个点

d.touch.sleep(5) 停留5s

d.touch.move(x,y) 移动到某点

d.touch.up(x,y) 在某点松开

复制代码
# 连续滑动 touch(手机图案解锁)
d.touch.down(0.841, 0.477).sleep(3).up(0.841, 0.477)  # 在0.841, 0.477点击3s后松开,实现长按
# 从0.841, 0.477移动到0.827, 0.234后在0.186, 0.268松开,开始点击的时候长按0.2s,因为touch执行的特别快,按住图标后手机程序还没反应过来就结束了,导致滑动没有任何效果
d.touch.down(0.841, 0.477).sleep(0.2).move(0.827, 0.234).move(0.186, 0.268).up(0.186, 0.268)

6.放大缩小

复制代码
# 放大缩小
d(resourceId="com.vivo.gallery:id/gallery_root_bottom").pinch_in()  # 缩小
d(resourceId="com.vivo.gallery:id/gallery_root_bottom").pinch_out()  # 放大
# 指定放大缩小范围(单指1初位置)(单指2初位置)(滑动后单指1的位置)(滑动后单指2的位置)
d(resourceId="com.vivo.gallery:id/gallery_root_bottom").gesture((0.51, 0.327),(0.51,0.484),(0.51,0.147),(0.51,0.772))

7.等待元素出现/消失

复制代码
# 等待元素出现或消失
bol = d(text="哈哈").wait(timeout=3.0)  # 等待元素出现,时长3s,3s内出现返回true,未出现返回false
bol=d(text='哈哈').wait_gone(timeout=3)  # 等待元素消失,时长3s,3s内消失true,未消失返回false

8.按键

复制代码
# 按键
d.press("enter")  # 目前仅支持 home, back, left, right, up, down, center, menu, search, enter,delete(or del), recent(recent apps), volume_up, volume_down,volume_mute, camera, power
# 或
d.keyevent("enter")

9.输入法切换

复制代码
# 输入法切换
d.set_fastinput_ime(True)  # 设置默认输入法与fastinputime输入法转变(True为fastinputime,false默认输入法)
print(d.current_ime())  # 查看当前输入法

10.模拟fastinputime输入法键盘操作

复制代码
# 模拟fastinputime输入法键盘操作
d.send_action(5)  # 下一步
# 或
d.send_action("next")

# 目前仅支持如下几个
"""
"go": 2,
"search": 3,
"send": 4,
"next": 5,
"done": 6,
"previous": 7
"""

11.截图

复制代码
# 截图
d.screenshot("test.png")  # 当前项目目录下

12.录制

1)安装依赖:pip install -U "uiautomator2[image]"

2)方法

复制代码
d.screenrecord('test.mp4')  # 开始
time.sleep(2)
d.screenrecord.stop()  # 结束

13.应用管理操作

1)获取当前页面信息

复制代码
print(d.app_current())  # 获取当前页面信息:package,activity,pid

2)安装app

复制代码
d.app_install("url")  # 安装app

3)启动app

复制代码
d.app_start("package_name")

4)获取app信息

复制代码
print(d.app_info("package_name"))  # 获取app信息

5)退出应用

退到后台

复制代码
d.app_stop("package_name")  # 返回主界面

清除缓存(杀进程)

复制代码
d.app_clear("package_name")  # 杀进程清除缓存

6)获取设备ip

复制代码
print(d.wlan_ip)  # 手机ip

7)获取设备信息(cpu,电池等)

复制代码
print(d.device_info)  # 获取设备信息(型号,cpu,电池等信息)

8)卸载app

复制代码
d.app_uninstall('tv.danmaku.bili')  # 卸载

9)等待应用启动

复制代码
"""
等待应用变为当前应用,返回pid,超时未启动成功则返回0
front为true表示等待app成为当前app,
默认为false,表示只要后台有这个应用的进程就会返回PID
"""
a=d.app_wait("com.tencent.wework",6,front=True)  # 返回pid
print(a)

13.全局设置

1)查看默认配置

复制代码
print(d.settings) 
"""
{
'fallback_to_blank_screenshot': False,
 'operation_delay': (0, 5),   点击元素后延迟0-5秒
 'operation_delay_methods': ['click', 'swipe'],  点击元素延迟时间生效的方法(可以增加press,send_keys等 )
 'wait_timeout': 20.0,  查找元素默认等待时长
 'xpath_debug': False  xpath日志
 }
"""

2)修改默认配置

复制代码
d.settings["wait_timeout"]=10  # 修改设置,按照字典来修改即可

全局等待时长还可通过implicitly_wait来设置

复制代码
d.implicitly_wait(10)

14.息/亮屏

复制代码
d.screen_off()  # 息屏(锁屏)
d.sleep(5)
d.screen_on()  # 亮屏

15.通知栏操作

复制代码
d.open_notification()  # 打开通知栏
d.open_quick_settings()  # 打开通知栏设置页

16.停止ATX服务

复制代码
d.service("uiautomator").stop()  # 停止atx服务

17.读取devices信息

复制代码
print(d.info)

三.实例

以市场上一个可以开播的软件为了实现登录开播

复制代码
import uiautomator2 as u2


class Uiautomator2App:
    def __init__(self):
        self.d = u2.connect()
        self.d.implicitly_wait(10)
        self.d.app_start("tv.dm")

    def login(self):
        self.d(text="其他登录方式").click()
        self.d(resourceId="android:id/button1").click()  # 密码登录
        self.d(resourceId="tv.dm:id/username").click()
        self.d.send_keys("用户名")
        self.d.send_action(5)
        self.d.send_keys("密码")
        self.d(resourceId="tv.dm:id/log_reg_checkbox").click()  # 勾选协议
        self.d(resourceId="tv.dm:id/btn_login").click()  # 登录

    def bo(self):
        while True:
            if self.d(resourceId="tv.dm:id/tab_text", text="首页").wait(timeout=3.0):
                self.d.click(0.487, 0.968)  # 进入直播页面
                break
            else:
                continue

        self.d.xpath(
            '//*[@resource-id="tv.dm:id/wtlTabs"]/android.widget.LinearLayout[1]/android.widget.RelativeLayout['
            '1]/android.widget.FrameLayout[1]').click()  # 开启直播

    def exit(self):
        self.d.app_clear("tv.dm:id")  # 退出应用


if __name__ == '__main__':
    u = Uiautomator2App()
    u.login()
    u.bo()
    u.exit()

import uiautomator2 as u2