monkeyrunner初试

Monkeyrunner学习心得

在网上下载并且配置好python，androidsdk和jdk的环境之后，在cmd中运行一下python，java -vesion和monkeyrunner，使之都可以成功运行。

学习过程：

1：引入程序所用的模块，使用别名

1）MonkeyRunner:这个类提供了用于连接monkeyrunner和设备或模拟器的方法，它还提供了用于创建用户界面显示提供了方法。

2）MonkeyDevice:代表一个设备或模拟器。这个类为安装和卸载包、开启Activity、发送按键和触摸事件、运行测试包等提供了方法。

3）MonkeyImage:这个类提供了捕捉屏幕的方法。这个类为截图、将位图转换成各种格式、对比两个MonkeyImage对象、将image保存到文件等提供了方法。

导入共有两个格式：

#其中第一种可以直接导入3个模块但是在之后的模块调用中会比较麻烦：

from com.android.monkeyrunner import MonkeyRunner,MonkeyDevice,MonkeyImage

#第二种是分3句分别导入，但是可以起别名，以后调用比较简单：

from com.android.monkeyrunner import MonkeyRunner as mr

from com.android.monkeyrunner import MonkeyDevice as md

from com.android.monkeyrunner import MonkeyImage as mi

#如果给导入的模块起了别名，就必须使用别名，否则会出现错误。

#比如连接设备或模拟器，起了以上别名后，命令应该如下：
device=mr.waitForConnection()

 2.连接到设备或模拟器

#参数1：超时时间，单位秒，浮点数。默认是无限期地等待。
#参数2：串deviceid，指定的设备名称。默认为当前设备（手机优先，比如手机通过USB线连接到PC、其次为模拟器）。
#默认连接：
device = MonkeyRunner.waitForConnection()
#参数连接：
device = MonkeyRunner.waitForConnection(1.0,'4df74b8XXXXXXX') 

 

3.向设备或模拟器安装APK 

#以下两种方式都是对的
device.installPackage('E:/qqyinyue/QQyinyue.apk')
device.installPackage('E:\qqyinyue\QQyinyue.apk')
#参数可以为绝对路径，也可为相对路径

 

4.卸载设备或模拟器中的APK 

#参数为APK包名
device.removePackage('com.tencent.qqmusic') 

 

5.启动任意的Activity(即就是启动程序)

#device.startActivity(component="包名/启动Activity")
#以下两种都OK
device.startActivity(component="com.tencent.qqmusic/com.tencent.qqmusic.activity.AppStarterActivity")
device.startActivity(component="com.tencent.qqmusic/.activity.AppStarterActivity")

首先，我们有必要说一下，如何获取一个app的package名和activity。这里，我们只描述一种获取方式。

使用aapt，其中aapt是sdk自带的一个工具，在sdkuilds-tools目录下：

    以存储在E盘的qq音乐为例，运行cmd，命令行中切换到aapt.exe目录，

方法一：

执行命令：aapt dump badging E:qqyinyueQQyinyue.apk ，注意，apk路径中一定不能有空格。

由上图可知：package name：com.tencent.qqmusic

activity：.activity.AppStarterActivity

方法一由于日志较多，寻找起来比较费劲，所以我们引出方法二。

方法二（推荐方法）：

把日志存储在特定的文件中，在文件中通过搜索关键字，得到包名及活动名，这里我把结果输出到F盘的log.txt中：

aapt dump badging E:qqyinyueQQyinyue.apk > E: esult.txt

到此，已经获取了app的package名和activity。

 

6.手机截图 

#获取设备的屏蔽缓冲区，产生了整个显示器的屏蔽捕获。（截图）
result=device.takeSnapshot()
#返回一个MonkeyImage对象（点阵图包装），我们可以用以下命令将图保存到文件
result.writeToFile('E:\qqyinyue\Test1_001.png','png')

 

7.暂停 

#暂停目前正在运行的程序指定的秒数
#MonkeyRunner.sleep(秒数，浮点数) 

MonkeyRunner.sleep(5)

  

8.字符串发送到键盘 

#device.type('字符串')
device.type('helloworld')

 

9.唤醒设备屏幕

#锁屏后,屏幕关闭，可以用下命令唤醒
device.wake()

 

10.重新启动手机

device.reboot()

 

11.模拟滑动

#device.drag(X,Y,D,S)
#X 开始坐标
#Y 结束坐标
#D 拖动持续时间(以秒为单位)，默认1.0秒
#S 插值点时要采取的步骤。默认值是10
device.drag((100,1053),(520,1053),0.1,10)

 

12.在指定位置发送触摸事件 

#device.touch(x,y,触摸事件类型)
#x,y的单位为像素
#触摸事件类型，请见下文中Findyou对device.press描述

device.touch(520,520,'DOWN_AND_UP')

 

13.发送指定类型指定键码的事件

 

#device.press(参数1:键码,参数2:触摸事件类型)
#参数1：见android.view.KeyEvent
#参数2，如有TouchPressType()返回的类型－触摸事件类型，有三种。
#1、DOWN 发送一个DOWN事件。指定DOWN事件类型发送到设备，对应的按一个键或触摸屏幕上。
#2、UP 发送一个UP事件。指定UP事件类型发送到设备，对应释放一个键或从屏幕上抬起。
#3、DOWN_AND_UP 发送一个DOWN事件，然后一个UP事件。对应于输入键或点击屏幕。

以上三种事件做为press()参数或touch()参数

#按下HOME键
device.press('KEYCODE_HOME',MonkeyDevice.DOWN_AND_UP) 
#按下BACK键
device.press('KEYCODE_BACK',MonkeyDevice.DOWN_AND_UP) 
#按下下导航键
device.press('KEYCODE_DPAD_DOWN',MonkeyDevice.DOWN_AND_UP) 
#按下上导航键
device.press('KEYCODE_DPAD_UP',MonkeyDevice.DOWN_AND_UP) 
#按下OK键
device.press('KEYCODE_DPAD_CENTER',MonkeyDevice.DOWN_AND_UP) 

 

 

KeyCode: 

home键 KEYCODE_HOME 

back键 KEYCODE_BACK 

send键 KEYCODE_CALL 

end键 KEYCODE_ENDCALL 

上导航键 KEYCODE_DPAD_UP 

下导航键 KEYCODE_DPAD_DOWN 

左导航 KEYCODE_DPAD_LEFT 

右导航键 KEYCODE_DPAD_RIGHT  

ok键 KEYCODE_DPAD_CENTER 

上音量键 KEYCODE_VOLUME_UP  

下音量键 KEYCODE_VOLUME_DOWN 

power键 KEYCODE_POWER 

camera键 KEYCODE_CAMERA 

menu键 KEYCODE_MENU

更多KeyCode http://developer.android.com/reference/android/view/KeyEvent.html

更多Monkeyrunner学习：http://developer.android.com/tools/help/monkeyrunner_concepts.html

 

Python:

同样，Monkeyrunner可以直接调用指定python脚本，将命令写到python文件里，命名例如***.py，然后我们再从命令行直接通过monkeyrunner运行它即可。比如，我们还是用上面的例子，语法如下：monkeyrunner ***.py。接下来monkeyrunner会自动调用***.py，并执行其中的语句，相当方便。

Monkeyrunner学习心得

在网上下载并且配置好python，androidsdk和jdk的环境之后，在cmd中运行一下python，java -vesion和monkeyrunner，使之都可以成功运行。

学习过程：

1：引入程序所用的模块，使用别名

1）MonkeyRunner:这个类提供了用于连接monkeyrunner和设备或模拟器的方法，它还提供了用于创建用户界面显示提供了方法。

2）MonkeyDevice:代表一个设备或模拟器。这个类为安装和卸载包、开启Activity、发送按键和触摸事件、运行测试包等提供了方法。

3）MonkeyImage:这个类提供了捕捉屏幕的方法。这个类为截图、将位图转换成各种格式、对比两个MonkeyImage对象、将image保存到文件等提供了方法。

导入共有两个格式：

#其中第一种可以直接导入3个模块但是在之后的模块调用中会比较麻烦：

from com.android.monkeyrunner import MonkeyRunner,MonkeyDevice,MonkeyImage

#第二种是分3句分别导入，但是可以起别名，以后调用比较简单：

from com.android.monkeyrunner import MonkeyRunner as mr

from com.android.monkeyrunner import MonkeyDevice as md

from com.android.monkeyrunner import MonkeyImage as mi

#如果给导入的模块起了别名，就必须使用别名，否则会出现错误。

#比如连接设备或模拟器，起了以上别名后，命令应该如下：
device=mr.waitForConnection()

 2.连接到设备或模拟器

#参数1：超时时间，单位秒，浮点数。默认是无限期地等待。
#参数2：串deviceid，指定的设备名称。默认为当前设备（手机优先，比如手机通过USB线连接到PC、其次为模拟器）。
#默认连接：
device = MonkeyRunner.waitForConnection()
#参数连接：
device = MonkeyRunner.waitForConnection(1.0,'4df74b8XXXXXXX') 

 

3.向设备或模拟器安装APK 

#以下两种方式都是对的
device.installPackage('E:/qqyinyue/QQyinyue.apk')
device.installPackage('E:\qqyinyue\QQyinyue.apk')
#参数可以为绝对路径，也可为相对路径

 

4.卸载设备或模拟器中的APK 

#参数为APK包名
device.removePackage('com.tencent.qqmusic') 

 

5.启动任意的Activity(即就是启动程序)

#device.startActivity(component="包名/启动Activity")
#以下两种都OK
device.startActivity(component="com.tencent.qqmusic/com.tencent.qqmusic.activity.AppStarterActivity")
device.startActivity(component="com.tencent.qqmusic/.activity.AppStarterActivity")

首先，我们有必要说一下，如何获取一个app的package名和activity。这里，我们只描述一种获取方式。

使用aapt，其中aapt是sdk自带的一个工具，在sdkuilds-tools目录下：

    以存储在E盘的qq音乐为例，运行cmd，命令行中切换到aapt.exe目录，

方法一：

执行命令：aapt dump badging E:qqyinyueQQyinyue.apk ，注意，apk路径中一定不能有空格。

由上图可知：package name：com.tencent.qqmusic

activity：.activity.AppStarterActivity

方法一由于日志较多，寻找起来比较费劲，所以我们引出方法二。

方法二（推荐方法）：

把日志存储在特定的文件中，在文件中通过搜索关键字，得到包名及活动名，这里我把结果输出到F盘的log.txt中：

aapt dump badging E:qqyinyueQQyinyue.apk > E: esult.txt

到此，已经获取了app的package名和activity。

 

6.手机截图 

#获取设备的屏蔽缓冲区，产生了整个显示器的屏蔽捕获。（截图）
result=device.takeSnapshot()
#返回一个MonkeyImage对象（点阵图包装），我们可以用以下命令将图保存到文件
result.writeToFile('E:\qqyinyue\Test1_001.png','png')

 

7.暂停 

#暂停目前正在运行的程序指定的秒数
#MonkeyRunner.sleep(秒数，浮点数) 

MonkeyRunner.sleep(5)

  

8.字符串发送到键盘 

#device.type('字符串')
device.type('helloworld')

 

9.唤醒设备屏幕

#锁屏后,屏幕关闭，可以用下命令唤醒
device.wake()

 

10.重新启动手机

device.reboot()

 

11.模拟滑动

#device.drag(X,Y,D,S)
#X 开始坐标
#Y 结束坐标
#D 拖动持续时间(以秒为单位)，默认1.0秒
#S 插值点时要采取的步骤。默认值是10
device.drag((100,1053),(520,1053),0.1,10)

 

12.在指定位置发送触摸事件 

#device.touch(x,y,触摸事件类型)
#x,y的单位为像素
#触摸事件类型，请见下文中Findyou对device.press描述

device.touch(520,520,'DOWN_AND_UP')

 

13.发送指定类型指定键码的事件

#device.press(参数1:键码,参数2:触摸事件类型)
#参数1：见android.view.KeyEvent
#参数2，如有TouchPressType()返回的类型－触摸事件类型，有三种。
#1、DOWN 发送一个DOWN事件。指定DOWN事件类型发送到设备，对应的按一个键或触摸屏幕上。
#2、UP 发送一个UP事件。指定UP事件类型发送到设备，对应释放一个键或从屏幕上抬起。
#3、DOWN_AND_UP 发送一个DOWN事件，然后一个UP事件。对应于输入键或点击屏幕。

以上三种事件做为press()参数或touch()参数

#按下HOME键
device.press('KEYCODE_HOME',MonkeyDevice.DOWN_AND_UP) 
#按下BACK键
device.press('KEYCODE_BACK',MonkeyDevice.DOWN_AND_UP) 
#按下下导航键
device.press('KEYCODE_DPAD_DOWN',MonkeyDevice.DOWN_AND_UP) 
#按下上导航键
device.press('KEYCODE_DPAD_UP',MonkeyDevice.DOWN_AND_UP) 
#按下OK键
device.press('KEYCODE_DPAD_CENTER',MonkeyDevice.DOWN_AND_UP) 

 

KeyCode: 

home键 KEYCODE_HOME 

back键 KEYCODE_BACK 

send键 KEYCODE_CALL 

end键 KEYCODE_ENDCALL 

上导航键 KEYCODE_DPAD_UP 

下导航键 KEYCODE_DPAD_DOWN 

左导航 KEYCODE_DPAD_LEFT 

右导航键 KEYCODE_DPAD_RIGHT  

ok键 KEYCODE_DPAD_CENTER 

上音量键 KEYCODE_VOLUME_UP  

下音量键 KEYCODE_VOLUME_DOWN 

power键 KEYCODE_POWER 

camera键 KEYCODE_CAMERA 

menu键 KEYCODE_MENU

更多KeyCode http://developer.android.com/reference/android/view/KeyEvent.html

更多Monkeyrunner学习：http://developer.android.com/tools/help/monkeyrunner_concepts.html

 

 

 

 

 

 

 

 

 

 

Python:

同样，Monkeyrunner可以直接调用指定python脚本，将命令写到python文件里，命名例如***.py，然后我们再从命令行直接通过monkeyrunner运行它即可。比如，我们还是用上面的例子，语法如下：monkeyrunner ***.py。接下来monkeyrunner会自动调用***.py，并执行其中的语句，相当方便。