Android初体验之Monkey和Monkeyrunner

目录(?)[+]

  1. Monkey
    1.  什么是Monkey
    2.  Monkey的特征
    3. Monkey的基本用法
    4. Monkey测试的停止条件
    5. 实例
  2. MonkeyRunner
    1. 什么是monkeyrunner
    2. monkeyrunner同monkey的区别
    3. monkeyrunner的测试类型
    4. 运行monkeyrunner
    5. monkeyrunner基本语法
    6. 实例
    7. monkeyRunner 的记录和回放


本文部分解释性语段摘自网络百科或其它BLOG,语句内容网络随处可见,也不知道谁是初始原创,便不再署名出处,如有雷同,还请见谅。


Monkey


 什么是Monkey


Monkey是Android中的一个命令行工具,可以运行在模拟器里或实际设备中。它向系统发送伪随机的用户事件流(如按键输入、触摸屏输入、手势输入等),实现对正在开发的应用程序进行压力测试。Monkey测试是一种为了测试软件的稳定性、健壮性的快速有效的方法。


 Monkey的特征

1、 测试的对象仅为应用程序包,有一定的局限性。

2、 Monky测试使用的事件流数据流是随机的,不能进行自定义。

3、 可对Test的对象,事件数量,类型,频率等进行设置。

Monkey的基本用法

基本语法如下:

[java] view plain copy
print ?
  1. adb shell monkey [options]   
adb shell monkey [options] 


options event-count
这个是配置monkey的设置,例如,指定启动那个包,不指定将会随机启动所有程序 这个是让monkey发送多少次事件

详细的monkey介绍,和options的参数请查看 (http://developer.android.com/guide/developing/tools/monkey.html)

如果不指定options,Monkey将以无反馈模式启动,并把事件任意发送到安装在目标环境中的全部包。


Monkey测试的停止条件

 
1、如果限定了Monkey运行在一个或几个特定的包上,那么它会监测试图转到其它包的操作,并对其进行阻止。

2、如果应用程序崩溃或接收到任何失控异常,Monkey将停止并报错。

3、如果应用程序产生了应用程序不响应(application not responding)的错误,Monkey将会停止并报错。


实例

下面是一个更为典型的命令行示例,它启动指定的应用程序,并向其发送500个伪随机事件:

[java] view plain copy
print ?
  1. adb shell monkey -p your.package.name -vvv 500 > monkeytest.txt  
adb shell monkey -p your.package.name -vvv 500 > monkeytest.txt

-p表示对象包  -v 为 verbose的缩写(信息级别就是日志的详细程度),就是详细输出事件等级,这个3个v就是输出等级1至3的所有事件.(使用管道命令将输出结果放到一个文本里面方便查看)


举例:

eclipse连接真机设备,Window打开CMD,命令行输入:adb shell,进入shell界面后:


我运行的是手机上的 计算器 程序,具体你可以指定自己的APP包名就可以了~

真机效果:


如图所示,它真的就是随机输入数值,随机按钮,随机…..的……………….缺点是我们不能控制触摸或按钮事件,接下来MonkeyRunner就要登场了~




MonkeyRunner


什么是monkeyrunner

monkeyrunner工具提供了一个API,使用此API写出的程序可以在Android代码之外控制Android设备和模拟器。通过monkeyrunner,您可以写出一个Python程序去安装一个Android应用程序或测试包,运行它,向它发送模拟击键,截取它的用户界面图片,并将截图存储于工作站上。monkeyrunner工具的主要设计目的是用于测试功能/框架水平上的应用程序和设备,或用于运行单元测试套件。


monkeyrunner同monkey的区别

Monkey工具直接运行在设备或模拟器的adb shell中,生成用户或系统的伪随机事件流。monkeyrunner工具则是在工作站上通过API定义的特定命令和事件控制设备或模拟器,它支持,自己编写插件,控制事件,随时截图,简而言之,任何你在模拟器/设备中能干的事情,MonkeyRunner都能干,而且还可以记录和回放。


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基本语法

[java] view plain copy
print ?
  1. monkeyrunner -plugin     
monkeyrunner -plugin   


具体介绍…看官方文档(http://developer.android.com/guide/developing/tools/monkeyrunner_concepts.html)


实例

连接真机(模拟器),打开CMD,进入:E:\android-sdk-windows\tools文件夹内(里面有monkeyrunner.bat)

创建一个Python脚本文件:testrunner.py,内容如下:

注意!如果monkeyrunner脚本文件要使用中文,记得格式保存为utf8,不然会ASCNII无法支持错误

[java] view plain copy
print ?
  1. #导入我们需要用到的包和类并且起别名  
  2. import sys  
  3. from com.android.monkeyrunner import MonkeyRunner as mr  
  4. from com.android.monkeyrunner import MonkeyDevice as md  
  5. from com.android.monkeyrunner import MonkeyImage as mi  
  6.    
  7. #connect device 连接设备  
  8. #第一个参数为等待连接设备时间  
  9. #第二个参数为具体连接的设备  
  10. device = mr.waitForConnection(1.0,‘e0d98451’)  
  11. if not device:  
  12.     print >> sys.stderr,”fail”  
  13.     sys.exit(1)  
  14. #定义要启动的Activity  
  15. componentName=’com.example.simulate/.ShellActivity’  
  16. #启动特定的Activity  
  17. device.startActivity(component=componentName)  
  18. mr.sleep(3.0)  
  19. #do someting 进行我们的操作  
  20. #输入 helloworld  
  21. device.type(’helloworld’)  
  22. #输入回车  
  23. device.press(’KEYCODE_ENTER’)  
  24. #return keyboard  
  25. #device.press(’KEYCODE_BACK’)  
  26. #——  
  27. #takeSnapshot截图  
  28. mr.sleep(3.0)  
  29. result = device.takeSnapshot()  
  30.    
  31. #save to file 保存到文件  
  32. result.writeToFile(’./shot1.png’,‘png’);  
#导入我们需要用到的包和类并且起别名 
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 连接设备 #第一个参数为等待连接设备时间 #第二个参数为具体连接的设备 device = mr.waitForConnection(1.0,'e0d98451') if not device: print >> sys.stderr,"fail" sys.exit(1) #定义要启动的Activity componentName='com.example.simulate/.ShellActivity' #启动特定的Activity device.startActivity(component=componentName) mr.sleep(3.0) #do someting 进行我们的操作 #输入 helloworld device.type('helloworld') #输入回车 device.press('KEYCODE_ENTER') #return keyboard #device.press('KEYCODE_BACK') #------ #takeSnapshot截图 mr.sleep(3.0) result = device.takeSnapshot() #save to file 保存到文件 result.writeToFile('./shot1.png','png');

接下来命令行输入:

[java] view plain copy
print ?
  1. monkeyrunner testrunner.py  
monkeyrunner testrunner.py


这是一个小的脚本文件,主要是启动com.example.simulate包名下的ShellActivity界面,接下来按下Enter按钮,最后截屏,并保存在当前目录下为shot1.png,可以在toosl文件夹下查看。


这个脚本的实质就是一个python脚本,懂python的朋友,可以利用这个实现非常强悍的功能~~~~~~~~~~~~~~~~~~~~~~~~



monkeyRunner 的记录和回放

这才是真正实用的功能,直接看代码,创建一个recoder.py:

[java] view plain copy
print ?
  1. #!/usr/bin/env monkeyrunner  
  2. # Copyright 2010, The Android Open Source Project  
  3. #  
  4. # Licensed under the Apache License, Version 2.0 (the “License”);  
  5. # you may not use this file except in compliance with the License.  
  6. # You may obtain a copy of the License at  
  7. #  
  8. #     http://www.apache.org/licenses/LICENSE-2.0  
  9. #  
  10. # Unless required by applicable law or agreed to in writing, software  
  11. # distributed under the License is distributed on an ”AS IS” BASIS,  
  12. # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
  13. # See the License for the specific language governing permissions and  
  14. # limitations under the License.  
  15.   
  16. from com.android.monkeyrunner import MonkeyRunner as mr  
  17. from com.android.monkeyrunner.recorder import MonkeyRecorder as recorder  
  18.   
  19. device = mr.waitForConnection()  
  20. recorder.start(device)  
#!/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)
命令行下运行:

[java] view plain copy
print ?
  1. monkeyrunner monkey_recorder.py  
monkeyrunner monkey_recorder.py

这时会弹出这样的界面:


按钮以及一些功能说明:

Button Description
Wait 等待时间
Press a Button 发送,MENU,HOME,or SEARCH 按钮.Press,Down,or Up事件
Type Something 发送一些字符串
Fling 用来操作虚拟键盘 
image
Export Action 将我们的脚本导出来
Refresh Display 刷新当前界面

自己随心所以创建一些事件脚本,想做什么就可以做什么,通过MonkeyRecorder这个工具来操作设备界面,事件编辑完后选择Export Actions,导出到我们tools目录下命名为:action.mr

我们看一下工具生成的action.mr脚本,如下:

[java] view plain copy
print ?
  1. TOUCH|{‘x’:297,‘y’:533,‘type’:‘downAndUp’,}  
  2. WAIT|{’seconds’:2.0,}  
  3. TOUCH|{’x’:136,‘y’:278,‘type’:‘downAndUp’,}  
  4. WAIT|{’seconds’:2.0,}  
  5. TOUCH|{’x’:123,‘y’:356,‘type’:‘downAndUp’,}  
  6. WAIT|{’seconds’:10.0,}  
  7. PRESS|{’name’:‘HOME’,‘type’:‘downAndUp’,}  
  8. WAIT|{’seconds’:2.0,}  
  9. TOUCH|{’x’:235,‘y’:720,‘type’:‘downAndUp’,}  
  10. WAIT|{’seconds’:2.0,}  
  11. TOUCH|{’x’:303,‘y’:630,‘type’:‘downAndUp’,}  
  12. WAIT|{’seconds’:2.0,}  
  13. TOUCH|{’x’:16,‘y’:71,‘type’:‘downAndUp’,}  
  14. WAIT|{’seconds’:2.0,}  
  15. TOUCH|{’x’:244,‘y’:735,‘type’:‘downAndUp’,}  
TOUCH|{'x':297,'y':533,'type':'downAndUp',}
WAIT|{'seconds':2.0,}
TOUCH|{'x':136,'y':278,'type':'downAndUp',}
WAIT|{'seconds':2.0,}
TOUCH|{'x':123,'y':356,'type':'downAndUp',}
WAIT|{'seconds':10.0,}
PRESS|{'name':'HOME','type':'downAndUp',}
WAIT|{'seconds':2.0,}
TOUCH|{'x':235,'y':720,'type':'downAndUp',}
WAIT|{'seconds':2.0,}
TOUCH|{'x':303,'y':630,'type':'downAndUp',}
WAIT|{'seconds':2.0,}
TOUCH|{'x':16,'y':71,'type':'downAndUp',}
WAIT|{'seconds':2.0,}
TOUCH|{'x':244,'y':735,'type':'downAndUp',}



然后需要制作一个运行这一系列动作的脚本:monkey_playback.py,保存到tools目录下:

[java] view plain copy
print ?
  1. #!/usr/bin/env monkeyrunner  
  2. # Copyright 2010, The Android Open Source Project  
  3. #  
  4. # Licensed under the Apache License, Version 2.0 (the “License”);  
  5. # you may not use this file except in compliance with the License.  
  6. # You may obtain a copy of the License at  
  7. #  
  8. #     http://www.apache.org/licenses/LICENSE-2.0  
  9. #  
  10. # Unless required by applicable law or agreed to in writing, software  
  11. # distributed under the License is distributed on an ”AS IS” BASIS,  
  12. # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
  13. # See the License for the specific language governing permissions and  
  14. # limitations under the License.  
  15.   
  16. import sys  
  17. from com.android.monkeyrunner import MonkeyRunner  
  18.   
  19. # The format of the file we are parsing is very carfeully constructed.  
  20. # Each line corresponds to a single command.  The line is split into 2  
  21. # parts with a | character.  Text to the left of the pipe denotes  
  22. # which command to run.  The text to the right of the pipe is a python  
  23. # dictionary (it can be evaled into existence) that specifies the  
  24. # arguments for the command.  In most cases, this directly maps to the  
  25. # keyword argument dictionary that could be passed to the underlying  
  26. # command.   
  27.   
  28. # Lookup table to map command strings to functions that implement that  
  29. # command.  
  30. CMD_MAP = {  
  31.     ’TOUCH’: lambda dev, arg: dev.touch(**arg),  
  32.     ’DRAG’: lambda dev, arg: dev.drag(**arg),  
  33.     ’PRESS’: lambda dev, arg: dev.press(**arg),  
  34.     ’TYPE’: lambda dev, arg: dev.type(**arg),  
  35.     ’WAIT’: lambda dev, arg: MonkeyRunner.sleep(**arg)  
  36.     }  
  37.   
  38. # Process a single file for the specified device.  
  39. def process_file(fp, device):  
  40.     for line in fp:  
  41.         (cmd, rest) = line.split(’|’)  
  42.         try:  
  43.             # Parse the pydict  
  44.             rest = eval(rest)  
  45.         except:  
  46.             print ’unable to parse options’  
  47.             continue  
  48.   
  49.         if cmd not in CMD_MAP:  
  50.             print ’unknown command: ’ + cmd  
  51.             continue  
  52.   
  53.         CMD_MAP[cmd](device, rest)  
  54.   
  55.   
  56. def main():  
  57.     file = sys.argv[1]  
  58.     fp = open(file, ’r’)  
  59.   
  60.     device = MonkeyRunner.waitForConnection()  
  61.       
  62.     process_file(fp, device)  
  63.     fp.close();  
  64.       
  65.   
  66. if __name__ == ‘__main__’:  
  67.     main()  
#!/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()


接下来运行我们的保存的脚本,然后,你就看到真机(模拟器),进行你刚才一样的操作~

[java] view plain copy
print ?
  1. E:\android-sdk-windows\tools>monkeyrunner monkey_playback.py action.mr  
E:\android-sdk-windows\tools>monkeyrunner monkey_playback.py action.mr


我的脚本是执行一些press down 和press up动作,同时会有延迟,之后按下home按钮,最后打开桌面的短信程序,并打开某一条信息~是不是有点像按键精灵的感觉?但是得依靠命令行执行脚本~~~


你可能感兴趣的:(Monkey,Monkeyrunner,android)