[Python知识库]uiautomator安卓测试python版本

uiautomator

uiautomator 是python的安卓自动化测试模块，需要在android4.1+（API 16~30）的版本上工作，只需要通过adb连接android设备，不需要在android设备上安装别的东西。

安装uiautomator

pip install uiautomator2

为了更好的写自动化脚本，需要在安卓设备中定位图标位置，在此需要安装weditor包

pip install weditor

此外为了模拟安卓设备，需要安装个模拟器，现在安装“雷电模拟器”，可以自行在网上下载。
现在需要使用adb工具找到模拟器设备，
ADB前置条件：
1.安装Android SDK，并将Android_HOME environment设置为正确路径。
2.在设备上启用ADB设置，并使用usb将android设备与PC连接。
3.允许在设备设置上从未知源安装应用程序。
在cmd中输入：

adb devices

即可得到设备的信息，下图就是说明设备已经连接上了。

有了上面的工具就可以进行安卓设备的测试了！

连接方法：
1.通过WIFI连接，这需要你的设备在同一个网络下：
假设设备的ip为11.1.1.1

import uiautomator2 as u2
d = u2.connect('http://11.1.1.1') 

2.USB，使用设备的序列号进行连接，这样在连接多个设备的时候就可以有选择的测试某个设备：

from uiautomator import Device
d = Device('emulator-5554')

Note:在下面的例子里，我们使用d代表安卓设备

基本API的使用

本部分通过一些简单的例子展示了设备的一些操作。
检索设备信息

import  uiautomator2 as u2
d=u2.connect(r'emulator-5554')
print(d.info)

下面是运行的结果
设备的关键事件操作
安卓设备的开关

# 打开屏幕
d.screen.on()
# 关上屏幕
d.screen.off()
#解锁屏幕
d.unlock()

检查设备是开还是关

d.info.get('screenOn') # 要求android >= 4.4

按键操作

d.press("home") # 按下home键
d.press("back") # 按下back键的常规方式
d.press(0x07, 0x02) # 按下编码 0x07('0') 和 0x02(META ALT)

此外还支持以下按键操作：
home back left right up down center menu search enter delete ( or del) recent (recent apps)
volume_up volume_down volume_mute camera power

设备的手势交互

点击屏幕

# click (x, y) on screen(x,y)为点击点的坐标
d.click(x, y)

长时间点击屏幕

# long click (x, y) on screen
d.long_click(x, y)
d.long_click(x, y, 0.5) #长按0.5s 默认`在这里插入代码片`

滑动屏幕

# swipe from (sx, sy) to (ex, ey)
d.swipe(sx, sy, ex, ey)
# swipe from (sx, sy) to (ex, ey) with 10 steps
d.swipe(sx, sy, ex, ey, steps=10)
d.swipe(sx, sy, ex, ey, 0.5) # 滑动0.5s默认

拖拽屏幕

# drag from (sx, sy) to (ex, ey)
d.drag(sx, sy, ex, ey)
# drag from (sx, sy) to (ex, ey) with 10 steps
d.drag(sx, sy, ex, ey, steps=10)
d.drag(sx, sy, ex, ey, 0.5) # 默认拖拽0.5s

屏幕操作

检索方向

orientation=d.orientation

设置方向

d.set_orientation("n") # 或"natural"
d.set_orientation("l") # 或"left"
d.set_orientation("r") # 或"right"

冻结/解冻旋转

# 冻结旋转
d.freeze_rotation()
# 取消冻结旋转
d.freeze_rotation(False)

截图

#屏幕截图并保存到本地文件
d.screenshot("C:/Users/25711/Desktop/kg/demo.png")

#或者获取PIL.Image格式，但是需要安装pillow
image=d.screenshot()
image.save("C:/Users/25711/Desktop/kg/demo.png")

#还可以获取opencv格式，但是需要安装numpy和cv2
import cv2
image=d.screenshot(format='opencv')
cv2.imwrite("C:/Users/25711/Desktop/kg/demo.png",image)

存储窗口层次结构

#获取转储的内容（unicode）
xml=d.dump_hierarchy()

打开通知或快速设置

d.open_notification()
d.open_quick_setting()

推送和提取文件

将文件推送到设备

#将文件推送到设备的文件夹
d.push("foot.txt","/data/")
#推动并重命名
d.push("foo.txt"."/data/data.txt")
#推送fileobj
with open("foo.txt","rb") as f:
	d.push(f,"/data/")
#推送文件并修改文件模式
d.push("foo.sh","/data/local/tmp/",mode=0o755)

从设备中提取文件

d.pull("/data/tmp.txt","tmp.txt")
#设备中不存在的文件会引发FileNotFondErr
d.pull("/data/some_not_exist.txt","tmp.txt")

APP管理

APP的安装
目前仅支持从url安装

d.app_install(url)

APP启动

d.app_start("包名")
#例如 微博

APP停止

#执行强制停止
d.app_stop("包名")
#执行应用清除
d.app_clear("包名")

停止所有APP的运行

#停止所有app
d.app_stop_all()
#停止除了（包名）之外的所有应用
d.app_stop_all(excludes=["包名"])

选择器Selecor

选择器用于识别当前窗口中的特定对象

# 要选text是'Clock'，className 是'android.widget.TextView' 的元素
d(text='Clock', className='android.widget.TextView')

选择器支持以下的参数
? text, textContains, textMatches, textStartsWith
? className, classNameMatches
? description, descriptionContains, descriptionMatches, descriptionStartsWith
? checkable, checked, clickable, longClickable
? scrollable, enabled,focusable, focused, selected
? packageName, packageNameMatches
? resourceId, resourceIdMatches
? index, instance

获取儿孙和同级对象

儿孙级

d(className="android.widget.ListView").child(text="Bluetooth")

同级

#获取sibling或child of sibling
d(text="Google").sibling(className="android.widget.ImageView")

通过text或description或instance,获取儿孙级的对象

# 获取儿孙中符合类名"android.widget.LinearLayout"，text包含"Bluetooth"
d(className="android.widget.ListView", resourceId="android:id/list").child_by_text("Bluetooth", className="android.widget.LinearLayout")

# 允许页面滚动搜索获得儿孙对象
d(className="android.widget.ListView", resourceId="android:id/list")
 .child_by_text(
    "Bluetooth",
    allow_scroll_search=True,
    className="android.widget.LinearLayout"
  )

相对位置

我们可以使用相对位置的方法获取视图中的对象：left,right,top,bottom
d(A).left(B) 表示选择A左侧的B
d(A).right(B) 表选择A 右侧的B
d(A).up(B), 表示选择A上方的B.
d(A).down(B), 表示选择在A下面的B.
因此对于“WIFI”开关，我们可以编写以下的代码：

# 选择"Wi Fi"右侧的"switch" 
d(text="Wi Fi").right(className="android.widget.Switch").click()

多个实例

有时候屏幕上包含多个相同特点的多个对象，那么我们将在选择器中使用“instance”属性

d(text="Add new",instance=0)

uiautomator也提供了类似列表的方法来处理类似的元素对象

#获取当前屏幕上带有文本“Add new”的元素的总数
d(text="Add new").count
#或者
len(d(text="Add new"))

#通过inde获取元素实例
d(text="Add new")[0]
d(text="Add new")[1]
...

#循环版本
for data in d(text="Add new"):
	data.info

在使用迭代器的时候，必须保证屏幕不变，否则会出现ui not found error

获取ui对象的状态和信息

检查制定ui对象是否存在

d(text="Setting").exists #如果存在，则为True,否则False
d.exists(text="Settings")

检索制定ui对象的信息

d(text="Settings").info

设置/清除可编辑字段的text

d(text="Settings").clear_text()
d(text="Settings").set_text("my text..")

对指定ui执行click

单击指定ui object

#点击ui对象的中心
d(text="Settings").click()
#最长等待时间为10秒，并单击，超时没有显示会报错
d(text="Settings").click(timeout=10)
#click别名，键盘操作的短名
d(text="Settings").tap()

长按指定ui对象

#长按指定的ui object
d(text="Setting").long_click()

指定ui object手势动作

将对象拖动到定点或另一个对象

#拖动ui object到point（x,y）
d(text="Setting").drag_to(x,y,duration=0.5)
#拖动ui object到另一个ui object（中心）
d(text="Settings").drag_to(text="Clock",duration=0.25)

两点手势

d(text="Settings").gesture((sx1, sy1), (sx2, sy2), (ex1, ey1), (ex2, ey2))  # s起点，e终点

制定ui object 两点手势

支持两种手势
in 从边缘到中心
out 从中心到边缘

#从边缘到中心
d(text="Settings").pinch_in(percent=100,steps=10)
#从中心到边缘
d(text="Settings").pinch_out()

等待指定的ui对象出现或消失

#等待ui对象出现
d(text="Settings").wait(timeout=3.0)
#等待ui object消失
d(text="Settings").wait_gone(timeout=1.0)

对（可滚动）ui对象执行fling

Fling（飞滑）一般用于水平或垂直翻页，可能的属性：horiz 或vert
forward 或backward 或toBegining 或toEnd

# fling默认垂直向前 
d(scrollable=True).fling()
# fling水平向前
d(scrollable=True).fling.horiz.forward()
# fling垂直向后
d(scrollable=True).fling.vert.backward()
# 垂直fling到开始
d(scrollable=True).fling.h或iz.toBeginning(max_swipes=1000)
# 垂直fling到末尾
d(scrollable=True).fling.toEnd()

对(可滚动)ui对象执行scroll

可能的属性: horiz 或 vert forward 或 backward 或 toBeginning 或 toEnd, 或 to

# scroll 默认垂直向前
d(scrollable=True).scroll(steps=10)
# scroll水平向前
d(scrollable=True).scroll.h或iz.forward(steps=100)
# scroll垂直向后
d(scrollable=True).scroll.vert.backward()
# 水平scroll到开始
d(scrollable=True).scroll.h或iz.toBeginning(steps=100, max_swipes=1000)
# 垂直scroll到末尾
d(scrollable=True).scroll.toEnd()
# scroll 向前垂直，直到出现指定ui object 
d(scrollable=True).scroll.to(text="Security")