快捷查看 win 系统版本, 视窗键 +r 打开运行窗口后, 输入 winver 回车
https://github.com/zhangzhao4444/Maxim
https://testerhome.com/topics/11719
快捷打开 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 模拟器配套使用的
关于 Android 开发环境的大家可以参考此人的博客
Android SDK Manager 和 AVD Manager 使用
Android 开发环境配置
该步骤,主要是为了部署 adb 工具而已,当然也有独立部署 adb 的方案.这个你按需选择吧,不过你既然要搞 android 相关了,android sdk 工具的部署最终还是逃不过的.
真机与模拟器
Android 模拟器 Genymotion
请参考http://www.iplaysoft.com/genymotion.html 自行安装配置
启动一模拟器后,用 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) for Android 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 command line.
- adb shell CLASSPATH=/sdcard/monkey.jar:/sdcard/framework.jar exec app_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 in mix 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 exec app_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
D:\>cd Maxim
D:\Maxim>dir
D:\Maxim 的目录
2018/02/03 10:08 <DIR> .
2018/02/03 10:08 <DIR> ..
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 in 0.214s)
D:\Maxim>adb push monkey.jar /sdcard
monkey.jar: 1 file pushed. 0.0 MB/s (121367 bytes in 2.628s)
确认被测 app packagename
这个请参考帖子Android 获取包名和 Activity 的几种方法
去替换掉 -p com.panda.videoliveplatform 为你的 packagename
adb shell CLASSPATH=/sdcard/monkey.jar:/sdcard/framework.jar exec app_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 原生命令行参数.
稍后更新.
附上原生 Monkey:
https://developer.android.com/studio/test/monkey.html
http://shark.farbox.com/post/xing-neng-ce-shi/monkeyyong-fa-zong-jie
adb shell CLASSPATH=/sdcard/monkey.jar:/sdcard/framework.jar exec app_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
整个工具并不难
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 in 0.214s)
D:\Maxim>adb push monkey.jar /sdcard
monkey.jar: 1 file pushed. 0.0 MB/s (121367 bytes in 2.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 in 0.101s)
同时注意,INPUTTEXT 在匹配到的 xpath 控件中输入 text 指定字符，输入需要提前安装 adbkeyboard , 且还需要在手机中手动设置为当前输入法
该输入法工具 在工程目录 D:\Maxim\test\ADBKeyBoard.apk 下.
D:\Maxim\test>adb install ADBKeyBoard.apk
Success
然后我们可以开始执行了:
D:\Maxim>adb shell CLASSPATH=/sdcard/monkey.jar:/sdcard/framework.jar exec app_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 效果出来了.
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
好了 剩下的 就很简单了. 我就不啰嗦了.
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/
