MonkeyRunner介绍

jane1229

本文是自己搜集的一点资料

文档内容参考包含了一下内容：
http://www.chuanke.com/v1983382-106000-218426.html
http://blog.csdn.net/zuoyu55/article/details/7718447
http://blog.csdn.net/simmer_ken/article/details/7637556
等等

其中包含自己写的几个例子，请大家多多指点。

什么是monkeyrunner
monkeyrunner工具提供了一个API，使用此API写出的程序可以在Android代码之外控制Android设备和模拟器。通过monkeyrunner，您可以写出一个Python程序去安装一个Android应用程序或测试包，运行它，向它发送模拟击键，截取它的用户界面图片，并将截图存储于工作站上。monkeyrunner工具的主要设计目的是用于测试功能/框架水平上的应用程序和设备，或用于运行单元测试套件，但您当然也可以将其用于其它目的。
使用monkeyrunner前，需要安装和配置JDK、SDK和Python。
二、monkeyrunner工具同Monkey工具的差别
Monkey：
Monkey工具直接运行在设备或模拟器的adb shell中，生成用户或系统的伪随机事件流。
monkeyrunner：
monkeyrunner工具则是在工作站上通过API定义的特定命令和事件控制设备或模拟器。

三、monkeyrunner的测试类型
1、多设备控制：monkeyrunner API可以跨多个设备或模拟器实施测试套件。您可以在同一时间接上所有的设备或一次启动全部模拟器（或统统一起），依据程序依次连接到每一个，然后运行一个或多个测试。您也可以用程序启动一个配置好的模拟器，运行一个或多个测试，然后关闭模拟器。
2、 功能测试： monkeyrunner可以为一个应用自动贯彻一次功能测试。您提供按键或触摸事件的输入数值，然后观察输出结果的截屏。
3、 回归测试：monkeyrunner可以运行某个应用，并将其结果截屏与既定已知正确的结果截屏相比较，以此测试应用的稳定性。
4、 可扩展的自动化：由于monkeyrunner是一个API工具包，您可以基于Python模块和程序开发一整套系统，以此来控制Android设备。除了使用monkeyrunner API之外，您还可以使用标准的Python os和subprocess模块来调用Android Debug Bridge这样的Android工具。
四、运行monkeyrunner
您可以直接使用一个代码文件运行monkeyrunner，抑或在交互式对话中输入monkeyrunner语句。不论使用哪种方式，您都需要调用SDK目录的tools子目录下的monkeyrunner命令。如果您提供一个文件名作为运行参数，则monkeyrunner将视文件内容为Python程序，并加以运行；否则，它将提供一个交互对话环境。
monkeyrunner的命令语法为：
monkeyrunner -plugin <plugin_jar> <program_filename> <program_options>
-plugin <plugin_jar>
为 monkeyrunner 指定一个包含插件的.jar 文件。学习更多内容见 Extending monkeyrunner with plugins.指定多个插件，请多次输入参数。
<program_filename>
如果您提供这个参数，monkeyrunner 命令 按 Python 程序的方式运行文件的内容；否则，它开启一个会话窗口。<程序选项>
<program_options>  
<program_file>中程序的标志和参数
五、monkerunner脚本基本方式
# 导入此程序所需的monkeyrunner模块
from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice
# 连接当前设备，返回一个MonkeyDevice对象
device = MonkeyRunner.waitForConnection()
# 安装Android包，注意，此方法返回的返回值为boolean，由此您可以判断安装过程是否正常
device.installPackage('myproject/bin/MyApplication.apk')
# 运行此应用中的一个活动 device.startActivity(component='com.example.android.myapplication.MainActivity')
# 按下菜单按键
device.press('KEYCODE_MENU','DOWN_AND_UP')
# 截取屏幕截图
result = device.takeSnapShot
# 将截图保存至文件
result.writeToFile('myproject/shot1.png','png')
六、实例
1、关于录制和回放，获取坐标点
1. 将以下代码拷贝到monkey_recorder.py
#!/usr/bin/env monkeyrunner
# Copyright 2010, The Android Open Source Project
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
from com.android.monkeyrunner import MonkeyRunner as mr
from com.android.monkeyrunner.recorder import MonkeyRecorder as recorder
device = mr.waitForConnection()
recorder.start(device)
2. 将以下代码拷贝到monkey_playback.py
#!/usr/bin/env monkeyrunner
# Copyright 2010, The Android Open Source Project
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
import sys
from com.android.monkeyrunner import MonkeyRunner
# The format of the file we are parsing is very carfeully constructed.
# Each line corresponds to a single command.  The line is split into 2
# parts with a | character.  Text to the left of the pipe denotes
# which command to run.  The text to the right of the pipe is a python
# dictionary (it can be evaled into existence) that specifies the
# arguments for the command.  In most cases, this directly maps to the
# keyword argument dictionary that could be passed to the underlying
# command.
# Lookup table to map command strings to functions that implement that
# command.
CMD_MAP = {
    'TOUCH': lambda dev, arg: dev.touch(**arg),
    'DRAG': lambda dev, arg: dev.drag(**arg),
    'PRESS': lambda dev, arg: dev.press(**arg),
    'TYPE': lambda dev, arg: dev.type(**arg),
    'WAIT': lambda dev, arg: MonkeyRunner.sleep(**arg)
    }
# Process a single file for the specified device.
def process_file(fp, device):
    for line in fp:
        (cmd, rest) = line.split('|')
        try:
            # Parse the pydict
            rest = eval(rest)
        except:
            print 'unable to parse options'
            continue
        if cmd not in CMD_MAP:
            print 'unknown command: ' + cmd
            continue
        CMD_MAP[cmd](device, rest)

def main():
    file = sys.argv[1]
    fp = open(file, 'r')
    device = MonkeyRunner.waitForConnection()
   
    process_file(fp, device)
    fp.close();
   
if __name__ == '__main__':
main()

3. 获取坐标点、脚本
(1)打开monkey_recorder.py

(2)录制操作


3、回放操作

2、MonkeyRunner执行Python脚本实例——发送短信(这是网上找的例子：连接：http://www.cnblogs.com/dimdusk/archive/2013/04/15/3011208.html)
目标：对手机短信程序进行压力测试。
#导入我们需要用到的包和类并且起别名
import sys
from com.android.monkeyrunner import MonkeyRunner as mr
from com.android.monkeyrunner import MonkeyDevice as md
from com.android.monkeyrunner import MonkeyImage as mi
#connect device 连接设备
#第一个参数为等待连接设备时间
#第二个参数为具体连接的设备ID
device = mr.waitForConnection(1.0,‘device_id’)
if not device:
    print >> sys.stderr,"fail"
    sys.exit(1)
#定义要启动的Activity
componentName='com.android.mms/.ui.BootActivity'
#启动特定的Activity
device.startActivity(component = componentName)
#等待时间，防止操作太快，设备反应不及时
mr.sleep(1.0)
#do someting 进行我们的操作
#新建短信
#参数是屏幕上坐标值，最后一个参数是动作
device.touch(57,747,'DOWN_AND_UP')
mr.sleep(1.0)
#输入收件人号码
device.type('10086')
#发送短信条数
for i in range(0,10):
    #输入短信内容
    device.touch(187,402,'DOWN_AND_UP')
    device.type('Hello')
    mr.sleep(1.0)
    #发送短信
    device.touch(432,380,'DOWN_AND_UP')
    mr.sleep(1.0)
    device.touch(51,752,'DOWN_AND_UP')
    mr.sleep(1.0)
#takeSnapshot截图
mr.sleep(1.0)
result = device.takeSnapshot()
#save to file 保存到文件，D盘的根目录下
result.writeToFile('d:\\result2.png','png');
3、monkeyrunner测试apk包安装卸载
from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice
device = MonkeyRunner.waitForConnection()
#install package NotesList.apk
#可以通过创建samples project 然后运行安装NotesList.apk到手机设备上
#device.installPackage('./installPackage/NotesList.apk')
device.installPackage('NotesList.apk')
print ('install success')
#remove package NotesList.apk
device.removePackage ('com.example.android.notepad')
print ('removed success')
MonkeyRunner.sleep(15)

4、使用控件ID写脚本

------------------------------------------------------------
由于帖子字数限制。。
如有需要可以下载附件。。。需要回复可见

游客，如果您要查看本帖隐藏内容请回复

猫星人

视频讲的很详细啊

aduocd

新手学习，顶~

ok146546

看看

Miss_love

这个要收藏

603282475

学习

tianzhiyi

如果您要查看本帖隐藏内容请回复

pp45qq

谢谢分享

ben_cym

非常感谢啊，很有用！！

bigtide

了解一下

rabbit-kitty

1234123443134123

REniu

shu0123

看看

2009520lin_he

回复，然后看看~

hylhsa

支持一个。。。

槑丫头_qq

很有用

大龙哥哥

大赞。。。谢谢楼主

jht385

看看

czt888888

谢谢分享

牵猫溜狗

。。。。。。。。。。。。。。。。