打造一款快速高效且高度可复用的 android 自动化测试工具 (qq 1 群 :608824162(已满) qq 2 群:745653339)

主页入口 请点我
https://github.com/zhangzhao4444/Maxim

优势

  1. 高速点击,每秒 10-15 action!
  2. 多平台兼容! 同时兼容 Android 5-9
  3. 轻量极简!

如何使用

  1. adb push  framework.jar  monkey.jar  文件到 /sdcard
  2. 执行 
    adb shell CLASSPATH=/sdcard/monkey.jar:/sdcard/framework.jar exec app_process /system/bin tv.panda.test.monkey.Monkey -p com.panda.videoliveplatform --uiautomatormix --running-minutes 60

    脱机运行(#53 楼

参数说明

  1. tv.panda.test.monkey.Monkey 主调入口  无需修改
  2. -p com.panda.videoliveplatform  待测 appid
  3. 策略模式

    --uiautomatormix 混合模式(70% 控件解析随机点击,其余 30% 按原 Monkey 事件概率分布) 
    --pct-uiautomatormix n 可自定义混合模式中控件解析事件概率
    --uiautomatordfs DFS 深度遍历算法(优化版)(注 Android5 不支持 dfs)
    --uiautomatortroy Troy 模式 见(#74 楼
    非以上两种为原始 Monkey 策略

  4. 执行时长
    --running-minutes 60        执行 60 分钟 monkey

  5. 场景细粒度控制
    --act-whitelist-file  /sdcard/awl.strings    自定义 Activity 白名单
    例:

    com.panda.videoliveplatform.activity.WelcomeActivity
    com.panda.videoliveplatform.activity.SplashWakeActivity
    com.panda.videoliveplatform.activity.MainFragmentActivity
    com.panda.videoliveplatform.activity.LiveRoomActivity
    

    锁定跳转只可进入其中的某个 Activity
    --act-blacklist-file        同上

  6. 其他参数及用法同原始 Monkey

特性简介

a. 速度快 每秒 10-15 个 Action 事件
界面控件解析算法通过改造底层 framework,直接使用 AccessibilityNodeInfo 并优化减化其调度流程,解析速度控制在 50ms 内,可对界面变化做快速反应。

{
    val clickable = ArrayList<AccessibilityNodeInfo>() 
    collectClickable(clickable, root)   //递归算法生成node树结构
    ......
    val node = clickable[random.nextInt(count)]
    val nodeRect = Rect()
    node.getBoundsInScreen(nodeRect)  //选取其中某个node的 rect ,随机点击其中某point

    generateClickEventAt(nodeRect, 0L)
}

b. Android 全平台兼容
兼容 Android5,6,7,8,p 各系列。通过反射原理动态解析各平台 Api 差异,使用一套逻辑兼容全系列。

{
    Class<?> clazz = mAm.getClass();
    String name = "setActivityController";    //存在差异的api
    Method method = findMethod(clazz, name, android.app.IActivityController.class);     //反射动态search api
    if (method != null) {
        ......
    }
    method = findMethod(clazz, name, android.app.IActivityController.class, boolean.class);
    if (method != null) {
        ......
}

c. 防跳出
控件解析时获取进程推栈 Top Activity,按非白即黑立即执行切回。各事件执行时按特有逻辑屏蔽掉状态栏,防止误操作。

{
     ......
     cn = this.mDevice.mAm.getTasks(1, 0).get(0).topActivity    //取top activity
     if (cn != null) currentPackage = cn.getPackageName()

     if (!MonkeyUtils.packageFilter.isPackageValid(currentPackage!!)) {    //判断非白即黑
         this.mQ.clear()
         this.generateActivity()
    ......
}

d. 防休眠
休眠时自动检测并唤醒屏幕。

{
    ......
    if (!this.mPM!!.isInteractive) {      //判断处于休眠中
        ......
        val i = Runtime.getRuntime().exec(arrayOf("input", "keyevent", "26")).waitFor()    //唤醒设备
    ......
}

e. 熔断机制
当事件按某个特有模式固定执行一段时间时则自动触发熔断开始自拉活,防止假死。如重复点击同一位置 n 秒。

private fun isBlocked(): Boolean{
    val jam = true
    ......
    val last = actionsHistory.last()
    for (i in 2..30){    //重复点击n次 触发熔断
        if (mVerbose > 1) Logger.log("last action is ${actionsHistory.size-1} code = $last, action${actionsHistory.size-i} code = ${actionsHistory[actionsHistory.size-i]}")
        if (last != actionsHistory[actionsHistory.size-i]){    
            return false
        }
    }
    //其他熔断
    .....
}

f. 场景细粒度
引入 Activity 黑白名单,可控制限定在某些场景内。如只测试某几个相关页面。

private inner class ActivityController : IActivityController.Stub() {
    override fun activityStarting(intent: Intent, pkg: String): Boolean {
        var allowActivity = true
        if (MonkeyUtils.activityFilter.hasValidActivitys()){
            val currentActivity: String? = try {intent.component.className} catch (e:Exception){null}
            if (currentActivity != null){
                allowActivity = MonkeyUtils.activityFilter.checkEnteringActivity(currentActivity)     //通过filter的才允许跳转
            }
            Logger.log("// Activity : ${currentActivity} in Intent")
        }
        ......
   }
    ......
}

g. 随机自动输入
检测当遇到可输入模式时,按设定(ape.string)或随机输入键盘事件。如输入 666 或 2333 弹幕
随机输入 需要提前安装 adbkeyboard
https://github.com/senzhk/ADBKeyBoard

{ 
    ......
    val inputMethodVisbleHight = this.mDevice.mIMM!!.getInputMethodWindowVisibleHeight()    //存在键盘输入栏
    if (inputMethodVisbleHight <= 0) return
    //注入键盘事件
    try { generateRandomKeyEvents() }catch (e : Exception){ }
    ......
}    

h. 崩溃堆栈自动保存
当崩溃(crash、oom)发生时自动抓取,并存于/sdcard/crash-dump.log

{ 
    override fun appCrashed(processName: String, pid: Int, shortMsg: String, longMsg: String, timeMillis: Long, stackTrace: String): Boolean {
            ......
            writeDumpLog("// CRASH: $processName (pid $pid) (dump time: $dateStr)")
            writeDumpLog("// Build Time: ${Build.TIME}")
            writeDumpLog("// ${stackTrace.replace("\n", "\n// ")}")
            ....
}    

todo

  1. 特殊事件序列 - 已完成
  2. 引入 GT 性能测试
  3. 控件黑名单 - 已完成
  4. xposed 模式 --见 xmonkey
  5. Ai 算法 模式

** 其他 **

扫盲贴: https://testerhome.com/topics/11884

常见问题排查

  1. 小米手机未开启 “开发者选项” -> "USB 调试(安全设置)允许通过 usb 调试修改权限或模拟点击"。
    开启后 ok 。报错 log 如下图

  2. accessibilityservice 被其他驱动占用 agent 未注销。如使用过 atx 未执行 unregister。
    执行 unregister 后 OK。报错 log 如下图,或无 log


  3. 厂商修改造成 dex 无法 load ,maxim 启动后就退出。实际什么都未执行。无 log 输出。 logcat 如下图。此问题暂时待查

4.运行 maxim 无任何 log,启动后就退出。需检查/sdcard/是否存在 monkey.jar ,framework.jar。部分机型发现 adb push 过去 monkey.jar 自动被更名成 monkey. 导致无法运行。

5.vivo7.1 运行 maxim 报错,需要关闭锁屏和开启 usb 模拟点击 ,然后就可以跑 monkey 了。报错如下:

update

#40 楼
支持特殊事件序列 max.xpath.actions
如何查看特殊事件 log #79 楼

#44 楼 #52 楼
支持屏蔽黑控件或黑区域 max.widget.black

#57 楼
支持截图,dump xml
崩溃回溯式截图 #92 楼

#74 楼
Troy 模式

#169 楼
Monkeyapi


↙↙↙阅读原文可查看相关链接,并与作者交流