CrashMonkey4IOS

iOS Monkey Test Tool.

###改进点:

1. 原先的CrashMonkey只支持iPhone Simulator测试，修改后支持真机测试(目前模拟器的兼容没有做)
2. 支持真机收集系统日志(Systemlog)，利用[deviceconsole][dc]实现
3. 支持真机收集崩溃日志(Crashlog)，利用[libimobiledevice][lidvc]的idevicecrashreport实现
4. 解决在iPhone5及以上分辨率的设备上测试报告截图手势坐标绘制错误的问题
5. 解决判定crash出现失败的情况。
6. 测试报告中添加设备信息及应用信息(Summary下)
7. 使用最新版的[UIAutoMonkey][uiatmonkey]，加入UI Holes与Application Not Repsonding ("ANR")的处理，添加[custom.js][custom]作为入口脚本.
8. 加入[tuneup][tp]依赖
9. 修改UIAutoMonkey.js中截图策略，为每个Event Action进行截图
10. 修改CrashMonkey中测试报告显示截图策略，增加至最近的50张
11. 解决大家一直所诟病的iOS App执行Monkey测试过程当中跳出程序后，导致脚本block，App无法自动返回的问题，解决方案：利用一个线程去监听instruments执行过程当中的日志，每隔20s进行前后比对，如果日志没有更新则说明App hanged，利用idevicedebug恢复App至前台。 [lidvc]:https://github.com/libimobiledevice/libimobiledevice [dc]:https://github.com/rpetrich/deviceconsole [uiatmonkey]: https://github.com/jonathanpenn/ui-auto-monkey/blob/master/UIAutoMonkey.js [custom]:https://github.com/vigossjjj/CrashMonkey4IOS/blob/master/lib/ui-auto-monkey/custom.js [tp]:https://github.com/vigossjjj/CrashMonkey4IOS/tree/master/lib/ui-auto-monkey/tuneup [troubleshooting]:https://github.com/vigossjjj/CrashMonkey4IOS/tree/master/Troubleshooting.md

###依赖及安装:

1. 安装Ruby运行环境，建议不要使用OS X自带版本，可自行使用RVM安装最新版的Ruby。建议使用淘宝镜像安装，速度比较快，$ sed -i -e 's/ftp\.ruby-lang\.org\/pub\/ruby/ruby\.taobao\.org\/mirrors\/ruby/g' ~/.rvm/config/db
2. 确保gem可用，也建议使用淘宝镜像 gem sources --remove https://rubygems.org/;gem sources -a http://ruby.taobao.org/;gem sources -l
3. 安装Homebrew ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

###使用说明:

1. 运行sh reset.sh安装相关依赖
2. 执行前需要先配置[custom.js][custom]相关参数
3. 执行命令/CrashMonkey4IOS/bin/smart_monkey -a ${App_BunnelID} -w ${iPhone_UDID} -n 1

###参数说明:

Usage: smart_monkey [options]
    -a app_name                      Target Application, abs path to simulator-compiled .app file or the bundle_id of the desired target on device(Required)
    -w device                        Target Device UDID(Required)
    -n run_count                     How many times monkeys run(default: 1)
    -d result_dir                    Where to output result(default: ./smart_monkey_result)
    -t time_limit_sec                Time limit of running(default: 100 sec)
    -s dsym_file                     Use .dSYM file to symbolicating crash logs
    -c custom_path                   Configuration custom.js Path
    -e extend_javascript_path        Extend Uiautomation Javascript for such Login scripts
        --compress-result compress_rate
                                     compress the screenshot images to save disk space!(example: 50%)
        --detail-count detail_event_count
                                     How many events to show in detail result page(default 50)
        --show-config                Show Current Configuration custom.js
        --drop-useless-img           Delete the un-displayed images of detial page.
        --list-app                   Show List of Installed Apps in iPhone/iPhone Simulator
        --list-devices               Show List of Devices
        --reset-iPhone-Simulator     Reset iPhone Simulator
        --version                    print crash monkey version

###TODO List:

1. 适配iPhone Simulator
2. 修改配置脚本及文档。

###Troubleshooting: 安装和执行测试遇到的问题解决方案请参看:[Troubleshooting.md][troubleshooting]

###测试报告: Summary: Detail: SystemLog: CrashLog: uiautotrace:

###参考文献：

1. https://github.com/mokemokechicken/CrashMonkey
2. https://github.com/jonathanpenn/ui-auto-monkey