• MonkeyRunner操作


    目录

    一、环境变量

    二、monkeyrunner

    三、运行monkeyrunner

    四、monkeyrunner命令语法

    五、导入需要的模块

    六、向设备或模拟器安装要测试的APK

    七、从设备中删除指定的软件包,包括其相关的数据和调整缓存

    删除成功返回true。八、启动任意的Activity

    九、暂停目前正在运行的程序指定的秒数

    十、写文件MonkeyImage

    十一、唤醒设备屏幕(在设备屏幕上唤醒)

     十二、重新引导到指定的引导程序指定的设备

    十三、在指定位置发送触摸事件(x,y的单位为像素)

    十四、发送到指定键的一个关键事件


    一、环境变量

    变量名:ANDROID_SDK_HOME
    变量值:C:\Documents and Settings\Administrator

    变量名:Path
    %SystemRoot%\system32;%SystemRoot%;C:\Python27;C:\py;D:\android \android-sdk-windows\tools;D:\android\android-sdk-windows\platform-tools

    android自动化测试框架:CTS、monkey、monkeyrunner、benchmark

    二、monkeyrunner

    monkeyrunner工具提供了一个API,运用该API编写的程 序可以不用通过android代码来直接控制android设备和模拟器,我们可以写一个python程序对android应用程序或测试包进行安装、运 行、发送模拟击键,对用户界面进行截图并将截图存储在workstation上等操作。monkeyrunner工具的主要设计目的是用于测试 application/framework层上的应用程序和设备、或用于运行单元测试套件,也可以用于其它目的。
    monkey工具,是直接运行在设备或模拟器的adb shell中,生成用户或系统的伪随机事件流。
    monkeyrunner为android测试提供了以下独特的功能:
    1、多设备控制:monkeyrunner API可以跨多个设备或模拟器实施测试套件。可以在同一时间接上所有设备或一次启动全部模拟器,依据程序依次连接到每一个,然后运行一个或多个测试。也可以用程序启动一个配置好的模拟器,运行一个或多个测试,然后关闭模拟器。
    2、功能测试:monkeyrunner可以为一个应用自动贯彻一次功能测试。您提供按键或触摸事件的输入数值,然后观察输出结果的截屏。
    4、回归测试:monkeyrunner可以运行某个应用,并将其结果截屏与既定已知正确的结果截屏相比较,以此测试应用的稳定性。
    4、 可扩展的自动化:由于monkeyrunner是一个API工具包,我们可以开发基于python模块和程式的一整套系统,以此来控制android设 备。除了使用monkeyrunner API,我们还可以使用标准的python os和ubprocess模块来调用android debug bridge这样的android工具。如ADB这样的android工具,也可以将自己写的类添加到monkeyrunner API中。


    三、运行monkeyrunner

    可以直接使用一个代码文件运行monkeyrunner,抑或在交互式 对话中输入monkeyrunner语句。不论使用哪种方式,你都需要调用SDK目录的tools子目录下的monkeyrunner命令。如果提供一个 文件名作为运行参数,则monkeyrunner将视文件内容为python程序,并加以运行;否则,它将提供一个交互对话环境。

    要运行monkeyrunner,请按照以下步骤进行操作:

    1. 打开命令行界面或终端

    2. 进入到你的Android SDK目录下的tools文件夹

    3. 输入以下命令以启动monkeyrunner:

      monkeyrunner
      

      如果无法启动,请确保你已经正确设置了ANDROID_HOME环境变量

    4. 输入你要运行的脚本文件的路径。例如:

      run myscript.py
      

      这会运行你的Python脚本文件。

    注意:在运行脚本之前,请确保你已经连接好了你的Android设备或器件,并且它被正确地识别并配置。


    四、monkeyrunner命令语法

    monkeyrunner -plugin <plugin_jar> <programe_filename> <programe_option>

    monkeyrunner API

    主要包括三个模块
    1、MonkeyRunner:这个类提供了用于连接monkeyrunner和设备或模拟器的方法,它还提供了用于创建用户界面显示提供了方法。
    2、MonkeyDevice:代表一个设备或模拟器。这个类为安装和卸载包、开启Activity、发送按键和触摸事件、运行测试包等提供了方法。
    3、MonkeyImage:这个类提供了捕捉屏幕的方法。这个类为截图、将位图转换成各种格式、对比两个MonkeyImage对象、将image保存到文件等提供了方法。

    注意:在运行monkeyrunner之前必须先运行相应的模拟器,否则monkeyrunner无法连接到设备
    运行模拟器有两种方法:1、通过eclipse中执行模拟器 2、在CMD中通过命令调用模拟器

    这里介绍通过命令,在CMD中执行模拟器的方法

    命令:

    emulator -avd test


    上面命令中test是指模拟器的名称。


    五、导入需要的模块

    1. import sys
    2. from com.android.monkeyrunner import MonkeyRunner as mr
    3. from com.android.monkeyrunner import MonkeyDevice as md
    4. from com.android.monkeyrunner import MonkeyImage as mi

    如果给导入的模块起了别名,就应该使用别名,而不能使用原名,否则会出现错误。
    比如连接设备或模拟器,起了以上别名后,命令应该如下:

    device=mr.waitForConnection()


    也可以采用以下方式

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

    也可以采用这种方式

    import com.android.monkeyrunner

    但是在使用时,就显得特别麻烦

    device=com.android.monkeyrunner.MonkeyRunner.waitForConnection()

    我们也可以给它一个别名

    import com.android.monkeyrunner as cam

    但是在使用时,就显得特别麻烦

    device=cam.MonkeyRunner.waitForConnection()


    #等待连接到设备,与模拟器连接,返回monkeydevice对象,代表连接的设备。没有报错的话说明连接成功。
    参数1:超时时间,单位秒,浮点数。默认是无限期地等待。
    参数2:串deviceid,指定的设备名称。默认为当前设备(手机优先,比如手机通过USB线连接到PC、其次为模拟器)。

    1. 默认连接:device=MonkeyRunner.waitForConnection()
    2. 参数连接:device = mr.waitForConnection(1.0,'emulator-5554')

    六、向设备或模拟器安装要测试的APK

    device.installPackage('myproject/bin/MyApplication.apk')

    #参数是相对或绝对APK路径
    路径级别用“/”,不能用“\”,比如d:\www\a.apk,而应该写成d:/www/a.apk
    安装成功返回true,此时查看模拟器我们可以在IDLE界面上看到安装的APK的图标了。
     


    七、从设备中删除指定的软件包,包括其相关的数据和调整缓存

    device.removePackage('myproject/bin/MyApplication.apk')

    删除成功返回true。

    八、启动任意的Activity

    1. device.startActivity(component="your.www.com/your.www.com.TestActivity")
    2. 或者
    3. device.startActivity(component="your.www.com/.TestActivity")


    此时可以向模拟器发送如按键、滚动、截图、存储等操作了。


    执行一个adb shell命令,并返回结果,如果有的话

    device.shell("...")



    九、暂停目前正在运行的程序指定的秒数

    MonkeyRunner.sleep(秒数,浮点数)

    获取设备的屏蔽缓冲区,产生了整个显示器的屏蔽捕获。(截图)

    result=device.takeSnapshot()

    返回一个MonkeyImage对象(点阵图包装),我们可以用以下命令将图保存到文件

    result.writeToFile('takeSnapshot\\result1.png','png')

    十、写文件MonkeyImage

    MonkeyImage.writeToFile(参数1:输出文件名,也可以包括路径,参数2:目标格式)

    写成功返回true,否则返回false

    键盘上的类型指定的字符串,这相当于要求每个字符串中的字符按(键码,DOWN_AND_UP).
    字符串发送到键盘

    device.type('字符串')

    十一、唤醒设备屏幕(在设备屏幕上唤醒)

    device.wake()

    可以通过使用monkeyrunner中的wake方法来唤醒设备屏幕。下面是一个示例脚本:

    1. import time
    2. from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice
    3. # 连接设备
    4. device = MonkeyRunner.waitForConnection()
    5. # 唤醒屏幕
    6. device.wake()
    7. # 等待屏幕亮起
    8. time.sleep(3)
    9. # 点击屏幕,以验证屏幕已唤醒
    10. device.touch(500, 500, MonkeyDevice.DOWN_AND_UP)

    在此示例中,我们首先使用waitForConnection方法连接到设备,并使用wake方法唤醒屏幕。然后我们等待3秒钟,以确保屏幕已完全唤醒,最后点击屏幕以验证唤醒成功。

     
    十二、重新引导到指定的引导程序指定的设备

    device.reboot()

    要将monkeyrunner重新引导到指定的引导程序指定的设备,请按照以下步骤操作:

    1. 通过命令行将monkeyrunner启动并连接到指定设备。例如:monkeyrunner -s <device-serial-number>

    2. 在monkeyrunner shell中输入以下代码:

      1. from com.android.monkeyrunner import MonkeyDevice
      2. from com.android.monkeyrunner import MonkeyRunner
      3. # 连接到设备
      4. device = MonkeyRunner.waitForConnection()
      5. # 重新引导到指定的引导程序
      6. device.reboot('bootloader')

    3. 如果需要将设备重新引导到引导程序中的特定选项(例如recovery)而不是默认的bootloader,则可以使用以下代码:

      device.reboot('<boot-option>')
      

      其中,<boot-option>是您想要进入的引导选项,例如recovery、fastboot等。

    请注意,重新引导设备会将其重置为出厂设置,因此请确保在执行此操作之前备份所有重要数据。

     

    =========================================================

    十三、在指定位置发送触摸事件(x,y的单位为像素)

    device.touch(x,y,TouchPressType-触摸事件类型)

    使用monkeyrunner发送触摸事件需要使用MonkeyDevice类的touch方法。下面是一个示例代码,演示如何在指定位置发送一个触摸事件:

    1. from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice
    2. # 连接设备
    3. device = MonkeyRunner.waitForConnection()
    4. # 指定触摸位置的坐标,单位为像素
    5. touch_x = 100
    6. touch_y = 200
    7. # 发送触摸事件
    8. device.touch(touch_x, touch_y, MonkeyDevice.DOWN_AND_UP)

    在上面的代码中,我们首先使用MonkeyRunner.waitForConnection()方法连接设备。然后,我们指定要发送触摸事件的位置,存储在touch_xtouch_y变量中。最后,我们使用device.touch()方法发送一个按下和释放的事件,具体事件类型为MonkeyDevice.DOWN_AND_UP。这将在屏幕上模拟一个触摸事件,就好像用户在该位置按下了手指并立即释放了手指一样。

     

    十四、发送到指定键的一个关键事件

    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()参数。原英文如下:

    use this with the type argument of press() or touch() to send a down event.

    为了模拟输入键,发送DOWN_AND_UP。
    参数1的部分具体内容逻辑:

    1. 按下HOME键 device.press('KEYCODE_HOME',MonkeyDevice.DOWN_AND_UP)
    2. 按下BACK键 device.press('KEYCODE_BACK',MonkeyDevice.DOWN_AND_UP)

  • 相关阅读:
    A^2=E | 方程的解 | 这个方程究竟能告诉我们什么
    2021年软件测试面试题大全
    网络安全、夺旗赛(CTF)技能汇总
    Altium Designer实用系列(四)----Ultra Librarian 下载芯片原理图库及封装并导入AD
    线上又出问题了!又是特殊场景,哎呀,当时怎么没有想到!
    html02-标签继续学习
    小程序员 scroll滚动与页面滚动冲突造成快速滑到底部卡顿失败问题
    Python数学基础-识图一、平面直角坐标系
    Linux ELF 可执行链接格式学习
    高数中值定理总结
  • 原文地址:https://blog.csdn.net/LYX_WIN/article/details/133066855