一 部署准备

项目地址

部署 Maxim

快捷打开 cmd, 视窗键 +r 打开运行窗口后,输入 cmd 回车

D: 回车进入 D:盘 准备直接 git clone 到 D:盘根目录下

D:\>git clone https://github.com/zhangzhao4444/Maxim.git

Cloning into 'Maxim'...

remote: Counting objects: 70, done.

remote: Compressing objects: 100% (54/54), done.

remote: Total 70 (delta 25), reused 60 (delta 15), pack-reused 0

Unpacking objects: 100% (70/70), done.

部署环境介绍

操作系统

快捷查看 win 系统版本, 视窗键 +r 打开运行窗口后, 输入 winver 回车

Android Sdk

下载地址 http://tools.android-studio.org/index.php/sdk 处下载 android-sdk_r24.4.1-windows.zip

将 android-sdk-windows 解压到你需要的目录下，笔者是 D:\Android\android-sdk-windows

配置 android-sdk 环境变量：

ANDROID_HOME 变量值为 android-sdk 的解压目录，笔者为 D:\Android\android-sdk-windows

PATH PATH 变量值的最后追加 ;%ANDROID_HOME%\tools;%ANDROID_HOME%\platform-tools;%ANDROID_HOME%\build-tools;

接下来你便可以用 D:\Android\android-sdk-windows 下的 SDK Manager.exe 下载配置 SDK 或 AVD Manager.exe 配置 AVD 模拟器了。

如果你需要测试 android 应用的话，请先安装配置好某一版本的 SDK 及其相关工具。

如下图,SDK manager 必要配置:

Tools->Options 设置

其它要下载的:

此处为了与 Macaca 环境兼容,目前稳定没敢乱升级,大家也可用此.

此处的按需选择与 AVD 模拟器配套使用的

该步骤,主要是为了部署 adb 工具而已,当然也有独立部署 adb 的方案.这个你按需选择吧,不过你既然要搞 android 相关了,android sdk 工具的部署最终还是逃不过的.

启动一模拟器后,用 adb 查看连接

D:\>adb devices -l

List of devices attached

192.168.60.101:5555 device product:vbox86p model:Samsung_Galaxy_S7___7_1_0___API_25___1440x2560 device:vbox86p

真机小米 Mix2

需要开启真机开发者选项->USB 调试, 模式和其他相关,主要是调试这一栏要打开的有

用 adb 查看连接

D:\>adb devices -l

List of devices attached

12345678 device product:chiron model:MIX_2 device:chiron

二查看使用帮助

Maxim 目录下 README.md

# Maxim

> A Kotlin implementation of Monkey TEST(Non-Stub) forAndroid that runs on Simulator/Android devices.

https://testerhome.com/topics/11719

## 1. Requirements

- Android 5，6，7，8

- Android5 not support dfs

## 2. Setup

- adb push framework.jar /sdcard

- adb push monkey.jar /sdcard

[- adb push ape.strings /sdcard]

[- adb push awl.strings /sdcard]

## 3. Usage

Maxim can be either started with adb commandline.

- adb shell CLASSPATH=/sdcard/monkey.jar:/sdcard/framework.jar execapp_process /system/bin tv.panda.test.monkey.Monkey -p com.panda.videoliveplatform --uiautomatordfs 5000

### 3.1 Args

[dfs mode] --uiautomatordfs monkey use DFS algorithm . About 5 action per second.

[mix mode] --uiautomatormix monkey use AccessibilityService resolve tree node and random choose. About 10-20 action per second.

--pct-uiautomatormix uiautomator action ratio inmix mode

--running-minutes n monkey total run time

--act-whitelist-file /sdcard/awl.strings

--act-blacklist-file

other args is same to Android Monkey

Maxim 目录下 使用帮助.docx

【环境预备】

支持 android 5，6，7，8

注 android 5不支持 dfs mode

将 framework.jar , monkey.jar push 到手机上某个目录中，比如/sdcard

【执行测试】

cmd 命令 ：

adb shell CLASSPATH=/data/local/tmp/monkey.jar:/data/local/tmp/framework.jar execapp_process /system/bin tv.panda.test.monkey.Monkey -p com.panda.videoliveplatform --uiautomatordfs 5000

蓝： monkey入口类

红： 被测app

绿： 测试策略

策略支持：

1. 模式 DFS

--uiautomatordfs

增加深度遍历算法

2. 模式 Mix

--uiautomatormix

直接使用底层accessibiltyserver获取界面接口 解析各控件，随机选取一个控件执行touch操作。

同时与原monkey 其他操作按比例混合使用

默认accessibilityserver action占比50%，其余各action分剩余的50%

accessibilityserver action占比可配置 --pct-uiautomatormix n

3. 保留原始monkey

4. 总运行时长

--running-minutes 3 运行3分钟

5. --act-whitelist-file /sdcard/awl.strings 定义白名单

--act-blacklist-file

其他参与与原始monkey一致

20180112 增加防跳出及切回、防误点状态栏及下拉状态栏

20180115 增加防睡眠及睡眠唤醒、防假死及自拉活机制

20180116 增加随机输入

随机输入 需要提前安装adbkeyboard

https://github.com/senzhk/ADBKeyBoard

随机输入默认随机输入字符，内容可自定义配置，格式如ape.strings文件，每行为随机输入项。

20180118 增加Activity黑白名单 格式如awl.strings，可对跳转做更细粒度控制，比如控制仅在几个特定Activity中跑monkey

20180119 framework兼容 Android5, 6, 7, 8.0

Android5 不支持dfs 模式，因5的accessibiltyserver缺少一个api。故不支持

增加 APP崩溃时自动保存堆栈信息到 /sdcard/crash-dump.log 注 追加保存

参数说明

tv.panda.test.monkey.Monkey 主调入口 无需修改

-p com.panda.videoliveplatform 待测appid

策略模式

--uiautomatormix 混合模式(70%控件解析随机点击，其余30%按原Monkey事件概率分布)

--pct-uiautomatormix n 可自定义混合模式中控件解析事件概率

--uiautomatordfs DFS深度遍历算法(优化版)(注 Android5不支持dfs)

非以上两种为原始Monkey策略

执行时长

--running-minutes 60 执行60分钟monkey

场景细粒度控制

--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 同上

其他参数及用法同原始Monkey

三 测试

向手机部署 Maxim 相关 D:\>cdMaxim

D:\Maxim>dir

D:\Maxim 的目录

2018/02/03 10:08

2018/02/03 10:08

2018/02/03 09:55 20 ape.strings

2018/02/03 09:55 447 ape.xpath.actions

2018/02/03 09:55 223 awl.strings

2018/02/03 09:55 1,149,240 framework.jar

2018/02/03 09:55 121,367 monkey.jar

2018/02/03 09:55 1,093 README.md

2018/02/03 09:55 33,644 使用帮助.docx

7 个文件 1,306,034 字节

2 个目录 85,022,330,880 可用字节

D:\Maxim>adb push framework.jar /sdcard

framework.jar: 1 file pushed. 5.1 MB/s (1149240 bytes in0.214s)

D:\Maxim>adb push monkey.jar /sdcard

monkey.jar: 1 file pushed. 0.0 MB/s (121367 bytes in2.628s)

执行

去替换掉 -p com.panda.videoliveplatform 为你的 packagename

adb shell CLASSPATH=/sdcard/monkey.jar:/sdcard/framework.jar execapp_process /system/bin tv.panda.test.monkey.Monkey -p com.sinacp.ggaicai --uiautomatormix --running-minutes 3

走你~~~~~~~~~~~~~~~~~

我只能说太特么快了,快到本家的 app,界面都来不及响应.

效果不错,这样我们的测试方案又多了一种了,以前的 Appcrawler 这种适合做随机遍历 或者 定制业务流遍历,

加上 Appetizer 插桩后又可以性能捕获和分析监控了.

个人觉得,这种暴力遍历 + 性能捕获 更能测试 App 稳定性,捕获的 Appetizer 分析报告,开发用了都说参考意义很大的咧.

剩下的要研究下那两个配置文件 ape.strings 和 awl.strings,默认还支持 mokey 原生命令行参数.

稍后更新.

四 更新补充 adb shell CLASSPATH=/sdcard/monkey.jar:/sdcard/framework.jar execapp_process /system/bin tv.panda.test.monkey.Monkey -p com.sinacp.ggaicai --uiautomatormix --running-minutes 3 --throttle 300 -v -v

太快的话,可以加上--throttle 300

--throttle 作用：在事件之间插入固定的时间(毫秒)延迟，你可以使用这个设置来减缓 Monkey 的运行速度，如果你不指定这个参数，则事件之间将没有延迟，事件将以最快的速度生成。一般设置为 300 毫秒，原因是实际用户操作的最快 300 毫秒左右一个动作事件，所以此处一般设置为 300 毫秒

加上-v -v 可以调整日志输出级别

-v -v 作用:Level1(-v -v)，提供了较为详细的测试信息，如逐个发送到 Activity 的事件信息。 这样在执行过程日志中,便可以看到遍历到的 currentActivity 当前被执行 Activity 名.

这个可以放入 黑白名单文件中 awl.strings .如

--act-whitelist-file /sdcard/awl.strings 或 --act-blacklist-file /sdcard/awl.strings

整个工具并不难

五 (MIX 模式) 增加支持 特殊事件序列

2018.02.23 update

需要配置 max.xpath.action 文件

案例：

[

{

"prob": 1,

"activity":"tv.panda.account.activity.WebLoginActivity",

"actions": [

{

"xpath": "//*[@class='android.widget.EditText']",

"action": "INPUTTEXT",

"text": "13810751000",

"index": 0,

"throttle": 300

},

{

"xpath": "//*[@class='android.widget.EditText']",

"action": "INPUTTEXT",

"text": "123400",

"index": 1,

"throttle": 300

},

{

"xpath": "//*[@content-desc='登录'and@class='android.view.View']",

"index": 0,

"action": "CLICK",

"throttle": 1000

}]

},

{

"prob": 1,

"actions": [

{

"xpath": "//*[@class='android.view.View']",

"index": 0,

"action": "SWIPE",

"args": "10,1000,800,1000,100",

"throttle": 3000

}]

},

{

"prob": 1,

"actions": [

{

"xpath": "//*[@class='android.view.View']",

"index": 0,

"action": "TOUCH",

"args": "500,1000",

"throttle": 1000

}]

}

]

上述包含 3 个特殊事件

发生概率 prob =1 为 100% 发生

仅当 当前 activity 为 tv.panda.account.activity.WebLoginActivity 时或无 activity 配置时做事件查找

xpath 为待查找控件的 xpath 支持复杂型 xpath，支持 index 索引选择

throttle 为该特殊步骤执行完后 sleep n 毫秒

Action 支持

1.Click 点击匹配到的 xpath 控件

2.INPUTTEXT 在匹配到的 xpath 控件中输入 text 指定字符，输入需要提前安装 adbkeyboard

3.TOUCH 点击指定坐标 args = (x,y)

4.SWIPE 按执行路径滑动 args = (x1,y1,x2,y2,step)

注 配置完成后请贴在 json.cn 检查格式，注意” : , 非中文

以上是作者的更新,接下来我们来体验

D:\Maxim>git pull

remote: Counting objects: 21, done.

remote: Compressing objects: 100% (6/6), done.

remote: Total 21 (delta 7), reused 13 (delta 7), pack-reused 8

Unpacking objects: 100% (21/21), done.

From https://github.com/zhangzhao4444/Maxim

2fcc38f..d406b60 master -> origin/master

Updating 2fcc38f..d406b60

Fast-forward

README.md | 2 ++

max.config | 2 ++

ape.strings => max.strings | 0

ape.xpath.actions => max.xpath.actions | 0

monkey.jar | Bin 121367 -> 131805 bytes

test/ADBKeyBoard.apk | Bin 0 -> 163634 bytes

"test/max.xpath.actions\346\241\210\344\276\2131" | 27 ++++++++++++++++

"test/max.xpath.actions\346\241\210\344\276\2132" | 35 +++++++++++++++++++++

...5\277\347\224\250\345\270\256\345\212\251.docx" | Bin 33644 -> 102828 bytes

9 files changed, 66 insertions(+)

create mode 100644 max.config

rename ape.strings => max.strings (100%)

rename ape.xpath.actions => max.xpath.actions (100%)

create mode 100644 test/ADBKeyBoard.apk

create mode 100644 "test/max.xpath.actions \346\241\210\344\276\2131"

create mode 100644 "test/max.xpath.actions \346\241\210\344\276\2132"

在工程目录下 D:\Maxim git pull 更新后,我们需要重新向连接的手机 push framework.jar 和 monkey.jar

D:\Maxim>adb push framework.jar /sdcard

framework.jar: 1 file pushed. 5.1 MB/s (1149240 bytes in0.214s)

D:\Maxim>adb push monkey.jar /sdcard

monkey.jar: 1 file pushed. 0.0 MB/s (121367 bytes in2.628s)

先优先编辑好 max.xpath.actions 配置 注意格式 和 英文符号编写

[

{

"prob": 1,

"activity":"com.huasheng.stock.ui.usercenter.LoginUI",

"actions": [

{

"xpath": "//*[@resource-id='com.huasheng.stock:id/account_num']",

"action": "INPUTTEXT",

"text": "13699901888",

"index": 0,

"throttle": 760

},

{

"xpath": "//*[@resource-id='com.huasheng.stock:id/pwd']",

"action": "INPUTTEXT",

"text": "hshshshs",

"index": 0,

"throttle": 760

},

{

"xpath": "//*[@text='登录' and @class='android.widget.Button']",

"index": 0,

"action": "CLICK",

"throttle": 1600

}]

}

]

书写该配置需要学习使用界面元素捕获工具,主要是为了获取 xpath 该值

1 android sdk 工具自带的 ** \tools\uiautomatorviewer.bat

2 appium-desktop 桌面版 appium 带的 inspector

3 Macaca 的 app-inspector

以上均可.

我遇到的问题是,这些元素捕获工具好像没有展示当前所捕获界面的 Activity,所以我只能先 带参数-v -v 来从 Maxim 的执行过程日志里找到,登录界面的 Activity

[Maxim] // : debug, currentActivity is com.huasheng.stock.ui.usercenter.LoginUI

同时注意,目前该 Maxim 版本,若要使用该 max.xpath.actions 配置,还需要将配置好的 max.xpath.actions push 到手机

D:\Maxim>adb push max.xpath.actions /sdcard

max.xpath.actions: 1 file pushed. 0.0 MB/s (744 bytes in0.101s)

同时注意,INPUTTEXT 在匹配到的 xpath 控件中输入 text 指定字符，输入需要提前安装 adbkeyboard , 且还需要在手机中手动设置为当前输入法

该输入法工具 在工程目录 D:\Maxim\test\ADBKeyBoard.apk 下.

D:\Maxim\test>adb installADBKeyBoard.apk

Success

然后我们可以开始执行了:

D:\Maxim>adb shell CLASSPATH=/sdcard/monkey.jar:/sdcard/framework.jar execapp_process /system/bin tv.panda.test.monkey.Monkey -p com.huasheng.stock --uiautomatormix --running-minutes 2 --throttle 680 -v -v

需要注意观察 Special Event 该段读入特殊事件的日志 ,是否读入配置成功.

[Maxim] // Special Event:

[Maxim] // Event1:

[Maxim] // Prob: 1.0

[Maxim] // Actvity: com.huasheng.stock.ui.usercenter.LoginUI

[Maxim] // Step0:

[Maxim] // XPath: //*[@resource-id='com.huasheng.stock:id/account_num']

[Maxim] // XPathExpression: org.apache.xpath.jaxp.XPathExpressionImpl@d4cb746

[Maxim] // Action: INPUTTEXT

[Maxim] // Text: 13699901888

[Maxim] // Throttle: 760

[Maxim] // Step1:

[Maxim] // XPath: //*[@resource-id='com.huasheng.stock:id/pwd']

[Maxim] // XPathExpression: org.apache.xpath.jaxp.XPathExpressionImpl@fa58d07

[Maxim] // Action: INPUTTEXT

[Maxim] // Text: hshshshs

[Maxim] // Throttle: 760

[Maxim] // Step2:

[Maxim] // XPath: //*[@text='鐧诲綍' and @class='android.widget.Button']

[Maxim] // XPathExpression: org.apache.xpath.jaxp.XPathExpressionImpl@4df5e34

[Maxim] // Action: CLICK

[Maxim] // Text:

[Maxim] // Throttle: 1600

还有,该段日志来确认是否正确启用了 adbkeyboard 输入法

[Maxim] // InputMethod ID: InputMethodInfo{com.android.adbkeyboard/.AdbIME, settings: null}.id

OK 效果出来了.

六(MIX 模式)支持黑控件 黑区域屏蔽

2018.02.28 update

1.(MIX 模式)支持黑控件 黑区域屏蔽

配置 max.widget.black

案例

[

{

"activity":"com.panda.videoliveplatform.activity.MainFragmentActivity",

"xpath": "//[@class='android.widget.TextView' and @text='我的校园' and @resource-id='com.panda.videoliveplatform:id/tv_title']"

},

{

"activity":"com.panda.videoliveplatform.activity.MainFragmentActivity",

"xpath": "//[@class='android.widget.TextView' and @text='车队' and @resource-id='com.panda.videoliveplatform:id/tv_title']",

"index": 0,

"bounds": "[0,633][900,789]"

},

{

"activity":"com.panda.videoliveplatform.activity.MainFragmentActivity",

"bounds": "[0,1107][900,1263]"

}

]

当且仅当 当前 activity == 所配 activity 或未配 activity 时 做黑检查

三种方式:

1.仅配置 bounds

屏蔽某个区域，在该区域内的控件或坐标不会被点击。

2.配置 xpath

查找匹配的控件，屏蔽点击该控件。

3.xpath+bounds

查找匹配的控件，当控件存在时屏蔽指定的区域。

注 配置完成后请贴在 json.cn 检查格式，注意” : , 非中文

将该文件 push 到 /sdcard/max.widget.black

以上是作者的更新,接下来我们来体验:

在工程目录下 D:\Maxim git pull 更新后,我们需要重新向连接的手机 push framework.jar 和 monkey.jar

先优先编辑好 max.widget.black 配置 注意格式 和 英文符号编写

xpath 就不多说了

今天来指导下什么是 bounds 属性,实际就是坐标值,在 appium API 我们经常会用到 tap 模拟手指点击

tap(self,positions,duration=None) 中的 positions 就是 bounds 属性坐标值.

如确定按钮的 bounds 属性坐标值.

如退出提示弹窗的 bounds 属性坐标值. 同样某一区域也有 bounds 属性坐标值,这样就可以屏蔽不点击某一 activity 下属的某一区域了.

编辑完同样需要将该文件 push 到 /sdcard

adb push max.xpath.actions /sdcard

好了 剩下的 就很简单了. 我就不啰嗦了.

七 TROY 模式(支持特殊事件、黑控件等)

2018.03.22 update

TROY 模式(支持特殊事件、黑控件等)配置 max.xpath.selector troy 控件选择子来定制自有的控件选择优先级，例子如下

[

{

"firstList":

[

{ "xpath": "//[contains(@text,'绝地求生')]" }

],

"selectList":

[

{ "xpath": "//[@clickable='true']" },

{ "xpath": "//[@clickable='true']//[contains(name(),'Text')]" },

{ "xpath": "//[@clickable='true']//[contains(name(),'Button')]" },

{ "xpath": "//[@clickable='true']//[contains(name(),'Image')]" }

],

"lastList":

[

{ "xpath": "//[../[@selected='true']]" },

{ "xpath": "//[../..//[@selected='true']]" },

{ "xpath": "//[../..//[@selected='true'] and contains(@resource-id,'tab_')]" },

{ "xpath": "//[contains(@resource-id,'HorizontalScrollView')]" }

],

"blackList":

[

{ "xpath": "//[contains(@resource-id,'wrapper_in_custom_title_bar')]//[contains(@resource-id,'right_button')]" },

{ "xpath": "//[contains(@resource-id,'share')]" }

]

}

]

控件选择策略 会按 1first 2select 3last 并屏蔽 black 来执行遍历操作。

adb shell CLASSPATH=/sdcard/monkey.jar:/sdcard/framework.jar exec app_process /system/bin tv.panda.test.monkey.Monkey -p com.panda.videoliveplatform --uiautomatortroy --running-minutes 15 -v -v

另注 max.xpath.selector 需要 push 到/sdcard/