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用法

观察者介绍

处理程序介绍

选择器介绍

基本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对象上滚动（可滚动）

    可能的属性：

    • horiz 要么 vert
    • forward或backward或toBeginning或toEnd或to
    ＃向前滚动（默认）垂直（默认） 
D（滚动= 真）.scroll（步骤= 10）
＃向前滚动horizentally 
D（滚动= 真）.scroll.horiz.forward（步骤= 100）
＃向后滚动垂直 
D（滚动= 真）.scroll.vert.backward（）
＃滚动到horizentally开始 
D（滚动= 真）.scroll.horiz.toBeginning（步骤= 100， max_swipes = 1000）
＃滚动到年底垂直 
D（滚动= 真）。 scroll.toEnd（）
＃向前滚动，直到垂直特定的UI对象出现 
D（滚动= 真）.scroll.to（文= “安全性”）

贡献

  • 分叉repo，并克隆到您的计算机。
  • 从检出一个新分支develop的分支
  • 安装要求： pip install -r requirements.txt
  • 进行更改，然后更新测试。不要忘记在“提供者”部分的末尾添加您的姓名
  • 通过所有的测试和代码必须包括：tox。
  • 提交你的修改，并提交拉请求develop分支。

贡献者

问题和讨论

如果您有任何错误报告或烦恼请报告给我们的问题跟踪GitHub的问题。

如果你有你想讨论任何建议，新的功能要求或话题，请提交您的主题ostio。

笔记

  • Android的uiautomator适用于Android 4.1及以上版本，所以在使用它之前，请确保你的设备是Android4.1 +。
  • 有些方法仅工作在Android 4.2 / 4.3，所以你最好阅读详细uiautomator的Java文档在使用它之前。
  • 该模块采用uiautomator-jsonrpc服务器作为后台程序与设备进行通信。
  • 该模块仅在python2.7 / 3.2 / 3.3 / pypy上测试。

常问问题

  • 无法启动JSONRPC服务器： raise IOError("RPC server not started!")

    它可能是由网络，设备或环境引起的。因此，当您遇到此问题，请按照以下步骤，尝试手动启动JSONRPC服务器。

    1. 从下载jar文件uiautomator jsonrpc服务器。

    2. Adb将下载的jar文件推送到 /data/local/tmp/

    3. 通过命令启动jsonrpc服务器：

      adb shell uiautomator runtest bundle.jar uiautomator-stub.jar -c com.github.uiautomatorstub.Stub

    4. Adb将本地端口转发到设备端口：

      adb forward tcp:9008 tcp:9008

    5. 检查jsonrpc服务器是否正常：

      curl -d '{"jsonrpc":"2.0","method":"deviceInfo","id":1}' localhost:9008/jsonrpc/0

      如果你看到类似的消息{"jsonrpc":"2.0","id":1,"result":{"currentPackageName":"android","displayHeight":1280,"displayRotation":0,"displaySizeDpX":0,"displaySizeDpY":0,"displayWidth":720,"productName":"falcon","sdkInt":17,"naturalOrientation":true}}，则表示服务器已启动。

    如果你可以手动启动jsonrpc服务器，但你的脚本总是满足IOError("RPC server not started!")，请提交问题github上的问题。

  • 错误 httplib.BadStatusLine: ''

    JsonRPC服务器需要访问设备上的临时目录，但在一些低层设备上，它可能会遇到错误，在访问临时文件没有连接SD卡。因此，如果您遇到错误，请插入SD卡，然后重试。

posted on 2017-06-19 23:51  alex.shu  阅读(1706)  评论(1)    收藏  举报

导航