Appium+python自动化(二十一)- Monkey指令操作手机
第一式 - 隐藏命令
monkey隐藏的两个命令:
–pck-blacklist-file<黑名单文件><br><br>–pck-whitelist-file<白名单文件>
monkey还有一个隐藏的命令那就是:
–f<脚本文件>:可以指定monkey的自定义脚本
一般monkey测试都是随机的测试事件,假如我们需要测试某一个特定的场景,普通的命令很难办到,这是就是需要自定义脚本这个命令了,它的使用方式也是很简单方便的,只要我们按照monkey的脚本规范写好脚本,之后将它保存到手机中,然后运行monkey的时候使用-f 命令指定脚本就行。
第二式 - monkey自定义脚本格式
1、虽然,Google 官方并没有提供对 MS 详细讲解的 API 文档,但是我们是可以通过源码来分析出 MS 支持的API的。
2、MS 的源码文件是:MonkeySourceScript.java
3、monkey的源码MonkeySourceScript.java类中有一段关于monkey脚本规则的描述MonkeySourceScript.java有兴趣的同学可以去看一下这个源码,这里以 5.1.1 为例子,进行讲解,其实这一块的代码变动非常的少,找一个版本了解即可。我们看一下源码(33行到46行)对j脚本规则描述。
脚本规则的描述
33/**34 * monkey event queue. It takes a script to produce events sample script format:35 *36 * <pre>37 * type= raw events38 * count= 1039 * speed= 1.040 * start data >>41 * captureDispatchPointer(5109520,5109520,0,230.75429,458.1814,0.20784314,0.06666667,0,0.0,0.0,65539,0)42 * captureDispatchKey(5113146,5113146,0,20,0,0,0,0)43 * captureDispatchFlip(true)44 * ...45 * </pre>46 */
解释他们的意思
#声明脚本的类型type= raw events#脚本的执行次数,由于monkey运行次数在命令设置的,这里的设置是无效的count= 10#事件执行时间间隔,这个也是通过命令来设置,这里不起作用speed= 1.0#脚本的入口,说明脚本从下面开始执行start data >>#下全是monkey命令captureDispatchPointer(5109520,5109520,0,230.75429,458.1814,0.20784314,0.06666667,0,0.0,0.0,65539,0)captureDispatchKey(5113146,5113146,0,20,0,0,0,0)captureDispatchFlip(true)
知道了monkey脚本书写的基本格式,在来看一眼monkey常见脚本API
1.LaunchActivity(包名,Activity名称)启动被测应用的某个Activity2.Tap(x,y,TapDuration)一次单击事件x,y:是坐标TapDuration:持续的时间,单位毫秒3.DispatchPress(keyName)模拟一个按键keyName:按键的名称4.RotateScreen(RotationDegree,peresist)旋转屏幕RotationDegree:0~3分别表示顺时针的四个方向peresist:是否存留5.DispatchFiip(true/false)打开或关闭软键盘6.LongPress()长按2秒7.PressAndHold(x,y,PressDuration)模拟长按事件x,y:点击的坐标PressDuration:持续时常,单位毫秒8.DispatchString(input)输入字符串input:输入的内容9.Drag(xStart,yStart,xEnd,yEnd,pCount)模拟拖动操作xStart,yStart:开始的坐标值xEnd,yEnd:结束的坐标值pCount:滑动事件的次数10.PinchZoom(pt1xStart,pt1yStart,pt1xEnd,pt1yEnd,pt2xStart,pt2ystart,pt2xEnd,pt2yEnd)手势缩放事件pt1xStart,pt1yStart:第一个手指起始的坐标位置pt1xEnd,pt1yEnd:第一个手指结束的坐标位置pt2xStart,pt2ystart:第二个手指开始的坐标位置pt2xEnd,pt2yEnd:第二个手指结束的坐标位置11.UserWait(sleepTime)设置睡眠时间sleepTime:等待时间,单位毫秒12.DeviceWake()唤醒设备屏幕
在源码中,所有我们上面介绍的 API 都是以一个 static final
的形式被声明。这里简单就 LaunchActivity 的方法的源码进行讲解,其他的 API 其实也大同小异。
LaunchActivity 的方法的源码讲解
1、浏览器输入源码地址,找到静态字符串LaunchActivity,如图:
2、将鼠标定位到静态字符串LaunchActivity通过ctrl(command)+🖱️左键我们可以定位到方法的位置。大约在597行,如图:
3、将鼠标定位到LaunchActivity的方法通过ctrl(command)+🖱️左键我们可以进入到方法代码。大约在597行,如图:
4、如上边LaunchActiviity 方法源码所示,LaunchActiviity 会以数组的形式接收两个参数,分别表示 PackageName 和 Activity 的 ClassName,下面具体对应的实现,我们就不细看了。再参照上面介绍的 API ,就可以很清晰的定位出方法和参数的含义了。
5、有兴趣的可以通过以上步骤一一查看哪些方法的API。
耍猴第三式 - monkey 脚本的实例
1、Monkey脚本主要包含两部分,一部分是头文件信息,一部分是具体的monkey命令。
2、按照2.1的脚本描述规则我们来编辑monkeyscript,如下:
type = usercount = 1speed = 500start data >>#启动应用程序LaunchActivity(com.michael.words,com.michael.words.activity.SplashActivity)UserWait(5000)#点击下步按钮Tap(615,609)UserWait(1000)#点击编辑框Tap(200,85,1000)#输入sgDispatchString(sg)
以上脚本主要操作过程:
1、点击夜神模拟器的应用中心
2、进入应用中心,点击搜索框
3、在搜索栏输入:test
4、结束
注意这里分别使用了 DispatchPress 和 DispatchString 来分别使用,就是为了做演示,实际你可以依赖场景选择使用的 API 。而其中涉及到坐标点的问题,这个在后面会讲解如何获取控件的坐标点。
执行脚本
1、编写好脚本,保存为monkey.script 文件。
2、通过 adb push 将其上传到待测试的设备中。要push到sdcard文件夹中(这里一夜神模拟器为例),如图:
adb push C:/Users/DELL/Desktop/monkey.script /sdcard/
3、查看有没有push到设备中,从下图可以看到成功的push进去了。如图:
4、有兴趣或者不相信的可以查看文件内容,如图:
5、然后通过 monkey -f
执行此脚本,例如下面执行 1次。
adb shell monkey -f /sdcard/monkey.script -v 1
6、效果截图,在应用中心的搜索栏里输入了:hongge。
7、执行完成之后,可以在控制台,看到输出的 Log 信息。
小结
1、通过adb pull和adb push 手机与电脑之间传输文件
(1)将手机卡中的某个文件复制到电脑
1,手机连接电脑后,在命令行输入 adb devices,获取到设备序列号后说明手机已经和电脑连接成功。
2,输入: adb pull 手机存储路径 电脑路径
adb pull /sdcard/xxx /Users/xxxx/xxx.tx
(2) 从电脑端向手机复制文件
1,输入: adb pull 电脑路径 手机存储路径
adb push /Users/xxxx/xxx.txt /sdcard/xxx
2、注意事项(此处有坑要注意!)
头文件代码书写注意“=”两边预留空格,否则会出现如下报错。
java.lang.NumberFormatException: Invalid int: ""