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自带的一个工具，在sdk\builds-tools\目录下：
以存储在E盘的qq音乐为例，运行cmd，命令行中切换到aapt.exe目录，
方法一：
执行命令：aapt dump badging E:\qqyinyue\QQyinyue.apk ，注意，apk路径中一定不能有空格。
由上图可知：package name：com.tencent.qqmusic
activity：.activity.AppStarterActivity
方法一由于日志较多，寻找起来比较费劲，所以我们引出方法二。
方法二（推荐方法）：
把日志存储在特定的文件中，在文件中通过搜索关键字，得到包名及活动名，这里我把结果输出到F盘的log.txt中：
aapt dump badging E:\qqyinyue\QQyinyue.apk > E:\result.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，并执行其中的语句，相当方便。
在网上下载并且配置好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自带的一个工具，在sdk\builds-tools\目录下：
以存储在E盘的qq音乐为例，运行cmd，命令行中切换到aapt.exe目录，
方法一：
执行命令：aapt dump badging E:\qqyinyue\QQyinyue.apk ，注意，apk路径中一定不能有空格。
由上图可知：package name：com.tencent.qqmusic
activity：.activity.AppStarterActivity
方法一由于日志较多，寻找起来比较费劲，所以我们引出方法二。
方法二（推荐方法）：
把日志存储在特定的文件中，在文件中通过搜索关键字，得到包名及活动名，这里我把结果输出到F盘的log.txt中：
aapt dump badging E:\qqyinyue\QQyinyue.apk > E:\result.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，并执行其中的语句，相当方便。
