原创

第3章1节《MonkeyRunner源码剖析》脚本编写示例: MonkeyRunner API使用示例(原创)

版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://techgogogo.blog.csdn.net/article/details/44117771

天地会珠海分舵注:本来这一系列是准备出一本书的,详情请见早前博文“寻求合作伙伴编写《深入理解 MonkeyRunner》书籍“。但因为诸多原因,没有如愿。所以这里把草稿分享出来,所以错误在所难免。有需要的就参考下吧,转发的话还请保留每篇文章结尾的出处等信息。

MonkeyRunner这个类可以说是编写monkeyrunner脚本的入口,因为这个类有一个很重要的方法watForConnection,它的作用就是去尝试去把monkeyrunner的后台和指定的设备建立好连接。只有连接上设备了,monkeyrunner才能驱动设备端的各种服务来操作被测应用。所以我们在编写monkeyrunner测试脚本的第一步往往就是去调用该方法来先建立好连接。

该方法接受两个参数,但用户可以填写,也可以不填写。第一个参数是以秒为单位的连接等待超时时长,默认不填写的话就是无限等待;第二个参数是设备id,该参数可以用正则表达式表示,默认不填写的话会指定第一个找到的设备。我们可以通过命令”adb devices -l”命令获得目标设备序列号:

图3-1-1 列出所有设备信息
图3-1-1 列出所有设备信息

该命令会列出所有连接上主机的安卓设备的基本信息,其中最左边的就是我们在找的设备id。大家应该有注意到上图所列出来的设备有两个,且他们的形式有很大的差别。这是因为通过adb连接设备的方式有两种,其中一种是直接通过usb协议来进行连接,一旦设备连接上主机就可以同通过该命令把设备给列出来;另外一种就是通过tcp来指定目标安卓机器的ip地址进行连接,用户需要执行”adb connect ip”来把地址为ip的设备给连接上主机,然后通过前面的命令就可以把设备列出来了。如果是用usb协议直接连接的话,列出来的设备id等同于设备的序列号,如果是通过tcp协议连接上来的话,列出来的设备id的格式是”ip:port”,其中ip就是目标设备的ip地址,port就是目标设备adbd的监听端口。

当然,MonkeyRunner这个类除了最关键的waitForConnection之外还有很多其他方法,且waitForConnection和这些方法一样都是静态方法,所以用户不需要去实例化MonkeyRunner就能直接使用这些方法。

本节我们会通过一个代码示例来看下在monkeyrunner脚本中应该如何调用waitForConnection方法来连接上设备的。该代码做的目标很简单,就是连接上设备后把该该目标安卓设备的序列号给打印出来。

该示例代码中除了会使用MonkeyRunner的waitForConnection方法外,还会用到它的一个alert方法来在连接失败的时候给用户弹出一个提示框,并且为了确定连接上的设备确实是我们想要的目标设备,还会调用下一节描述的MonkeyDevice的getSystemProperty方法来获得设备序列号并打印出来,以下把用到的这些方法的使用列出如下给大家参考:

表格3-1-1 示例代码所用关键方法列表
表格3-1-1 示例代码所用关键方法列表

示例代码如下:

代码3-1-1 MonkeyRunner - waitForConnection示例

1 from com.android.monkeyrunner import MonkeyRunner,MonkeyDevice
  2 
  3 DEVICEID = "192.168.1.102:5555"
  4 TIMEOUT = 30
  5 
  6 try:
  7     #Connect to specific device
  8     device = 
        MonkeyRunner.waitForConnection(TIMEOUT,DEVICEID)
  9 
 10     #Sleep 3 seconds
 11     MonkeyRunner.sleep(3)
 12 
 13     print device.getSystemProperty("ro.serialno")
 14 except:
 15     MonkeyRunner.alert("Faield to connect to device","Exception occurs","OK")

由于这是我们的第一个脚本示例,所以这里我们会逐行对代码进行解析:

  • 第1行: 从monkeyrunner.jar库的com.android.monkeyrunner这个包引入MonkeyRunner和MonkeyDevice这两个类,因为测试脚本使用的是jython语言编写,所以可以调用java编写的库。有了这两个类,主要是有了MonkeyRunner这个类后,我们就可以连接上设备了
  • 第3-4行:定义调用MonkeyRunner的waitForConnection方法时需要两个参数,目标安卓机器的id和连接等待超时
  • 第8行:把超时等待时长和目标设备id作为参数调用MonkeyRunner的waitForConnection方法,注意该方法成功后会返回MonkeyDevice的实例
  • 第11行:调用MonkeyRunner的sleep方法来让测试用例先等待3秒钟,以防设备没有完全准备好
  • 第13行:调用MonkeyDevice实例的getSystemProperty方法取得目标安卓设备的序列号,并打印出来
  • 第14-15行:如果连接waitForConnection连接目标安卓设备失败的话会抛出异常,这两行的目的就是把异常捕捉到并调用MonkeyRunner的alert方法在主机端弹出一个弹出框来提醒用户

编写好测试用例后就可以调出monkeyrunner命令来将该jython脚本给跑起来了。下面是成功获得序列号后的输出结果:

图3-1-3 输出结果-成功获得序列号
图3-1-3  输出结果-成功获得序列号

如果连接设备失败,比如设备id没有找到的话,脚本会弹出一个提示框来告诉用户连接目标设备失败相关的信息:

图3-1-4 连接设备失败弹出框
图3-1-4 连接设备失败弹出框

——— 未完待续———


作者:天地会珠海分舵
微信公众号:TechGoGoGo
微博:http://weibo.com/techgogogo
CSDN:http://blog.csdn.net/zhubaitian

文章最后发布于: 2015-03-07 17:00:17
展开阅读全文
0 个人打赏

没有更多推荐了,返回首页

©️2019 CSDN 皮肤主题: 大白 设计师: CSDN官方博客

分享到微信朋友圈

×

扫一扫,手机浏览