Android 自动化测试

Python +Android +uiautomator test 在init中定义的方法

uiautomator

该模块是android的一个python包装uiautomator 测试框架。它适用于Android 4.1+，只需通过adb连接Android设备，无需在Android设备上安装任何东西。

从 uiautomator 进口设备的 ð 

d.screen.on（）
D（id= “时钟”）。点击（）

安装

$ pip install uiautomator

前提条件

安装Android的SDK，并设置ANDROID_HOME环境以正确的路径。
启用设备上的ADB设置，并使用USB连接您的Android设备与您的电脑。

导入uiautomator

如果ANDROID_SERIAL在环境中定义的，或只有一个连接的设备：
```
从 uiautomator 进口设备的 ð
```

检索设备对象时，限制序列号

从 uiautomator 进口设备

ð =设备（' 014E05DE0F02000E “）

speficy在其他计算机上运行的adb服务器主机和端口

虽然亚行支持-a选项SDK 4.3以来，但现在它有一个bug。在所有接口而不是localhost上启动adb服务器侦听的唯一方法是adb -a -P 5037 fork-server server &
```
从 uiautomator 进口设备

ð =设备（' 014E05DE0F02000E '，adb_server_host = “ 192.168.1.68 ”，adb_server_port = 5037）
```

注：在下面的例子中，我们使用d代表Android设备对象。

基本API用法

此部分通过一些简单的示例显示设备的正常操作。

检索设备信息

d.info

以下是可能的结果：

{ u'displayRotation': 0,
  u'displaySizeDpY': 640,
  u'displaySizeDpX': 360,
  u'currentPackageName': u'com.android.launcher',
  u'productName': u'takju',
  u'displayWidth': 720,
  u'sdkInt': 18,
  u'displayHeight': 1184,
  u'naturalOrientation': True
}

关键事件设备的操作

打开/关闭屏幕

＃在屏幕上打开 
d.screen.on（） ＃关闭屏幕 
d.screen.off（）

替代方法是：

＃唤醒设备 
d.wakeup（） ＃睡眠设备，一样关闭屏幕。
d.sleep（）

按硬/软键

＃按home键 
d.press.home（） ＃按返回键 
d.press.back（） ＃正常的方式按返回键 
d.press（ “回”）
＃按下键码0×07（0）与元ALT （0X02）上 
d.press（ 0x的 07， 0X 02）

目前支持下列键：
- home
- back
- left
- right
- up
- down
- center
- menu
- search
- enter
- delete（或del）
- recent（最近的应用程式）
- volume_up
- volume_down
- volume_mute
- camera
- power
你可以找到所有关键代码定义的Android的KeyEvent。

手势设备的交互

单击屏幕

＃点击（X，Y）在屏幕上 
d.click（X，Y）

长按屏幕

＃长按（X，Y）在屏幕上 
d.long_click（X，Y）

滑动

＃从（SX，SY）轻扫（EX，EY） 
d.swipe（SX，SY，EX，EY） ＃从（SX，SY）轻扫（EX，EY）与10个步骤 
d.swipe（SX，SY ，前，安永，步骤= 10）

拖动

＃从（SX，SY）拖动（EX，EY） 
d.drag（SX，SY，EX，EY） ＃从（SX，SY）拖动（EX，EY）与10个步骤 
d.drag（SX，SY ，前，安永，步骤= 10）

屏幕设备的操作

检索/设置方向

可能的方向是：

natural 要么 n
left 要么 l
right 要么 r
upsidedown或u（不能设定）

＃检索方向，也可能是“天然”或“左”或“右”或“upsidedown” 
方向 = d.orientation
＃设置定向和冻结旋转。
＃指出：“upsidedown”不能设置到Android 4.3的。
d.orientation =  “升”  ＃或“左”的 
d.orientation =  “ - [R ”  ＃或“右” 
d.orientation =  “ ñ ”  ＃或“自然”

冻结/取消冻结旋转

＃冻结旋转 
d.freeze_rotation（） ＃取消冻结旋转 
d.freeze_rotation（假）

截取屏幕截图

＃采取截图并保存到本地文件“home.png”，直到Android 4.2或不能工作。
d.screenshot（ “ home.png ”）

转储窗口层次结构

＃转储widown层次结构并保存到本地文件“hierarchy.xml” 
d.dump（ “ hierarchy.xml ”）
＃或获得回报倾倒内容（Unicode）的。
XML = d.dump（）

打开通知或快速设置

＃开放的通知，不能工作，直到Android 4.3的。
d.open.notification（） ＃开启快速设定，不能工作，直到Android 4.3的。
d.open.quick_settings（）

等待空闲或窗口更新

＃等待当前窗口空闲 
d.wait.idle（） ＃等待，直到窗口更新事件发生 
d.wait.update（）

观察者

你可以注册守望者执行某些动作时，选择器不能找到匹配。

注册观察者

当选择器找不到匹配项时，uiautomator将运行所有注册的观察器。

条件匹配时点击目标

d.watcher（ “ AUTO_FC_WHEN_ANR ”）。当（文= “ ANR ”）。当（文= “等待”） 
                             。点击（文字= “强制关闭”）
 ＃ d.watcher（名）##创建一个新的命名观察者。
＃   。当（条件）##观察者的UiSelector条件。
＃   。点击（目标）##执行对目标UiSelector点击动作。

条件匹配时按键

d.watcher（ “ AUTO_FC_WHEN_ANR ”）。当（文= “ ANR ”）。当（文= “等待”） 
                             .press.back.home（） ＃另类的方式来定义它，如下 
d.watcher（ “ AUTO_FC_WHEN_ANR ”）。当（文= “ ANR ”）。当（文= “等待”） 
                             。按（“回”，“家”）
 ＃ d.watcher（名）##创建一个新的名为守望。＃   。当（条件）##观察者的UiSelector条件。＃   。按<键名> ...... <键名>。（）##按下按键逐个顺序。＃   Alternavie方式定义按键顺序是按（<keybname>，...，<键名>）

检查命名的监视器是否触发

触发观察者，这意味着观察者运行并且其所有条件都匹配。
```
d.watcher（ “ watcher_name ”）.triggered
 ＃真在指定守望的情况下触发，否则为假
```

删除命名监视器

＃删除观察者 
d.watcher（ “ watcher_name ”）上卸下摆臂（）

列出所有观察者

d.watchers
 ＃所有注册wachers'名称的列表

检查是否有任何观察者触发

d.watchers.triggered
 ＃   真正的触发任何看守的情况下，

重置所有触发的观察者

＃重置所有触发观察家，在那之后，d.watchers.triggered会是假的。
d.watchers.reset（）

Remvoe观察者

＃删除所有已注册的观察家 
d.watchers.remove（） ＃删除指定的守望者一样，同样d.watcher（“watcher_name”）。remove（）方法 
d.watchers.remove（ “ watcher_name ”）

强制运行所有观察者

＃力量来运行所有注册的观察者 
d.watchers.run（）

处理程序

处理程序的功能与Watcher相同，只是它实现了我们的Android uiautomator。处理程序和观察程序之间最不同的用法是，处理程序可以使用自定义的回调函数。

高清 fc_close（设备）：
   如果设备（文= '强制关闭“）.exists：
    设备（文= '强制关闭”）。点击（）
   返回 真  ＃返回True手段打破处理程序回调函数的循环。

＃在处理回调函数反过来 
d.handlers.on（fc_close） ＃关闭句柄回调函数 
d.handlers.off（fc_close）

选择器

选择器是标识当前窗口中的特定ui对象。

＃要入围对象，文字是“时钟”和它的类名是“android.widget.TextView' 
D（文= '时钟'，的className = ' android.widget.TextView '）

选择器支持以下参数。请参阅UiSelector DOC java的详细信息。

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

子对象和同级UI对象

儿童

＃得到孩子或孙子 
D（的className = “ android.widget.ListView ”）.child（文= “蓝牙”）

兄弟

＃得到同胞的兄弟姐妹或子女 
D（文= “谷歌”）.sibling（的className = “ android.widget.ImageView ”）

子文本或描述或实例

＃得到孩子匹配的className =“android.widget.LinearLayout” 
＃而且它或它的子女或孙子包含文本“蓝牙” 
D（的className = “ android.widget.ListView ”， RESOURCEID = “机器人：ID /列表”） 
.child_by_text（ “蓝牙”，的className = “ android.widget.LinearLayout ”）＃允许滚动搜索，获得子 
D（的className = “ android.widget.ListView ”， RESOURCEID = “机器人：ID /列表”）
。 child_by_text（ “蓝牙”，
   allow_scroll_search = 真，
  的className = “ android.widget.LinearLayout ” 
）

child_by_description是找到子哪个或哪些是孙子包含指定的描述中，其他是相同的child_by_text。
child_by_instance是在其子层次结构中指定实例的任何位置找到具有子UI元素的子项。这是一个没有可见的意见进行滚动。

详情请参阅以下链接：

UiScrollable，getChildByDescription，getChildByText，getChildByInstance
UiCollection，getChildByDescription，getChildByText，getChildByInstance

上面的方法支持链接调用，例如对于下层

< 节点 指数 = “ 0 ” 文本 = “ ” 资源ID = “机器人：ID /列表” 级 = “ android.widget.ListView ” ...> 
  < 节点 指数 = “ 0 ” 文本 = “ WIRELESS ＆ NETWORKS ” 资源-id = “ ” 类 = “ android.widget.TextView ” ... /> 
  < 节点 索引 = “ 1 ” 文本 = “ ” 资源ID = “ ” 类 = “ android.widget.LinearLayout ” ...> 
    < 节点 指数 = “ 1 ” 文本 = “ ” 资源ID = “ ” 级 = “ android.widget.RelativeLayout ” ...> 
      < 节点 指数 = “ 0 ” 文本 = “无线网络连接” 资源ID = “机器人： ID /标题“ 级 = ” android.widget.TextView “ ... /> 
    </ 节点 > 
    < 节点 指数 = ” 2 “ 文本 = ” ON “ 资源ID = ” com.android.settings：ID / switchWidget “ 类 = “ android.widget.Switch ” ... /> 
  </ 节点 > 
  ... 
</ 节点 >

我们要点击文本“Wi-Fi”右侧的开关打开/打开Wi-Fi。因为有几个开关，几乎相同的属性，所以我们不能使用类似d(className="android.widget.Switch")选择的UI对象。相反，我们可以使用下面的代码来选择它。

D（的className = “ android.widget.ListView ”，RESOURCEID = “机器人：ID /列表”） 
  .child_by_text（ “无线网络连接”，的className = “ android.widget.LinearLayout ”） 
  .child（的className = “机器人.widget.Switch “） 
  。点击（）

相对位置

此外，我们可以用相对位置的方法来获取视图：left，right，top，bottom。
- d(A).left(B)，意味着在左侧选择B。
- d(A).right(B)，表示选择A右侧的B.
- d(A).up(B)，表示选择B以上的A.
- d(A).down(B)，表示在A下选择B.
所以对于上面的情况，我们可以写代码：
```
＃＃选择的“无线网络连接”右侧的“开关” 
D（文= “无线网络连接”）.right（的className = “ android.widget.Switch ”）。点击（）
```

多个实例

有时，屏幕可能包含多个视图与相同的例如文本，那么你将不得不使用选择器中的“实例”属性，如下所示：

D（文= “新增”，比如= 0）   ＃这意味着一审文本“新增”

但是，uiautomator提供了类似的方法来使用它。

＃得到的文本意见的计当前屏幕上的“添加新的” 
D（文= “新增”）.Count之间＃一样count属性LEN（D（文= “新增”）） ＃通过索引获取实例 
ð （文= “新增”）[ 0 ]
D（文= “新增”）[ 1 ]
 ... ＃迭代器的视图中 D（文= “添加新”）：
    view.info  ＃ ...

注意：当您使用选择喜欢的列表，你必须确保屏幕保持不变，否则你可能会得到UI未找到错误。

获取所选的ui对象状态及其信息

检查特定ui对象是否存在

D（文= “设置”）.exists ＃是否存在真，否则假 
d.exists（文= “设置”）＃以上财产的别名。

检索特定ui对象的信息

D（文= “设置”）.INFO

以下是可能的结果：

{ u'contentDescription': u'',
  u'checked': False,
  u'scrollable': False,
  u'text': u'Settings',
  u'packageName': u'com.android.launcher',
  u'selected': False,
  u'enabled': True,
  u'bounds': {u'top': 385,
              u'right': 360,
              u'bottom': 585,
              u'left': 200},
  u'className': u'android.widget.TextView',
  u'focused': False,
  u'focusable': True,
  u'clickable': True,
  u'chileCount': 0,
  u'longClickable': True,
  u'visibleBounds': {u'top': 385,
                     u'right': 360,
                     u'bottom': 585,
                     u'left': 200},
  u'checkable': False
}

设置/清除可编辑字段的文本

D（文= “设置”）.clear_text（）  ＃清除文字 
D（文= “设置”）.set_text（ “我的文字...... ”）   ＃设置文本

对选中的ui对象执行单击操作

点击特定的ui对象

＃点击特定的UI对象的中心 
D（文= “设置”）。单击（）
＃点击具体的UI对象的bottomright角落 
D（文= “设置”））.click.bottomright（
＃请点击具体的UI对象的左上边角 
D（文= “设置”）.click.topleft（）
＃点击等到新窗口更新 
D（文= “设置”）.click.wait（）

长时间点击特定的ui对象

＃长按一下特定的UI对象的中心 
D（文= “设置”）.long_click（）
＃长按具体的UI对象的bottomright角落 
D（文= “设置”）.long_click.bottomright（）
＃长按具体的UI对象的左上边角 
D（文= “设置”）.long_click.topleft（）

针对特定ui对象的手势动作

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

＃注：拖不能设置到Android 4.3的。
＃拖拽的UI对象，以点（X，Y） 
D（文= “设置”）.drag.to（X，Y，步骤= 100）
＃拖拽的UI对象到另一个UI对象（中心）， 
D（文= “设置“）.drag.to（文= ”时钟“，步骤= 50）

从ui对象的中央滑动到其边缘

滑动支持4个方向：

left
right
top
bottom

D（文= “设置”）.swipe.right（）
D（文= “设置”）.swipe.left（步骤= 10），
D（文= “设置”）.swipe.up（步骤= 10），
D（文字= “设置”）.swipe.down（）

两点手势从一个点到另一个点

D（文= “设置”）.gesture（（SX1，SY1），（SX2，SY2）） 
                  。要（（EX1，EY1），（EX2，EY2））

在特定ui对象的两点姿态

支持两种手势：

In，从边到中心
Out，从中心到边缘

＃注：捏不能设置到Android 4.3的。
＃从边缘到中心。这里是“在”不“，在” 
D（文= “设置”）.pinch.In（百分比= 100，步= 10）
＃从中心到边缘 
D（文= “设置”）.pinch.Out（）

等待特定ui对象出现或消失

＃等到UI对象出现 
D（文= “设置”）.wait.exists（超时= 3000）
＃等待，直到UI对象转眼 
D（文= “设置”）.wait.gone（超时= 1000）

对特定的ui对象执行fling（可滚动）

可能的属性：

horiz 要么 vert
forward或backward或toBeginning或toEnd

＃一扔前进（默认）垂直（默认） 
D（滚动= 真）.fling（）
＃一扔前进horizentally 
D（滚动= 真）.fling.horiz.forward（）
＃一扔向后垂直 
D（滚动= 真）.fling .vert.backward（）
＃一扔到horizentally开始 
D（滚动= 真）.fling.horiz.toBeginning（ max_swipes = 1000）
＃来结束垂直一扔 
D（滚动= 真）.fling.toEnd（）

在特定的ui对象上滚动（可滚动）