Fastbot-Android Open Source Handbook
Introduction
Fastbot is a model-based testing tool for modeling GUI transitions to discover app stability problems. It combines machine learning and reinforcement learning techniques to assist discovery in a more intelligent way.
Related: Fastbot-iOS
***More detail see at Fastbot architecture
Features
- Fastbot is compatible with multiple Android OS systems, including original Android, Android 5-13 and a variation of modified Andriod-based system by domestic manufacturers.
- Inherited from original Monkey, Fastbot allows for fast action insertion as high as 12 actions per second.
- Expert system is equipped with the ability to customize deeply based on needs from different business lines.
- Fastbot is a model-based-testing tool. Model is build via graph transition with the consideration of high reward choice selection.
- Fastbot supports non-standard widgets by computer vision techniques such as YOLOv3, ocr and cv segmentation.
update 2023.3
- support android 13
update 2022.1
- update Fastbot Revised License
- release AnyTrace, the Fastbot test management assistant: supports one-click Fastbot test start, crash analysis, etc. (AnyTrace User Manual)
update 2021.11
- support android 12
- add some new GUI fuzzing & mutation features (inspired/supported by Themis)
update 2021.09
- Fastbot supports model reuse: see at
/sdcard/fastbot_[packagename].fbm
. This file is loaded by default if it exists when Fastbot starts. During execution, it is overwritten every 10 minutes. The user can delete or copy this file based on their needs.
Usage
Environment preparation
- Make sure Android version on your device or emulator is Android 5, 6, 7, 8, 9, 10, 11, 12
- Push
framework.jar fastbot-thirdpart.jar monkeyq.jar
into your device, most likely /sdcard, pushlibs/*
to/data/local/tmp/
adb push *.jar /sdcard adb push libs/* /data/local/tmp/
Run Fastbot with shell command
adb -s device_vendor_id shell CLASSPATH=/sdcard/monkeyq.jar:/sdcard/framework.jar:/sdcard/fastbot-thirdpart.jar exec app_process /system/bin com.android.commands.monkey.Monkey -p package_name --agent reuseq --running-minutes duration(min) --throttle delay(ms) -v -v
-
before run the command,user can push the strings in apk to
/sdcard/
to improve the modelaapt2
oraapt
depends your android sdk, a sample aapt path is${ANDROID_HOME}/build-tools/28.0.2/aapt2
aapt2 dump --values strings [testApp_path.apk] > max.valid.strings adb push max.valid.strings /sdcard
For more Details, please refer to the handbook in 中文手册
required parameters
-s device_vendor_id # if multiple devices allowed, this parameter is needed; otherwise just optional
-p package_name # app package name under test, the package name for the app under test can be acquired by "adb shell pm list package", once the device is ensured for connection by "adb devices"
--agent robot # strategy selected for testing, no need to modify
--running-minutes duration # total amount time for testing
--throttle delay # time lag between actions
optional parameters
--bugreport # log printed when crash occurs
--output-directory /sdcard/xxx # folder for output directory
optional fuzzing data
adb push data/fuzzing/ /sdcard/
adb shell am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///sdcard/fuzzing
Results Explanation
Observed crash and ANR
- Observed Java crash, ANR and native crash will be written into /sdcard/crash-dump.log
- Observed ANR will be written into /sdcard/oom-traces.log
Activity coverage data
- Total activity list will be printed in shell after Fastbot job done, together with explored activity list and rate of coverage in this job run.
- Equation for total activity coverage: coverage = exploredActivity / totalActivity * 100%
- Be aware for totalActivity: The list totalActivity is acquired through framework interface PackageManager.getPackageInfo. Contained activities in the list includes many abandoned, invisible or not-reachable activities.
Acknowledgement
- We appreciate the insights and code contribution from project APE by Dr. Tianxiao Gu and Prof. Zhendong Su (ETH Zurich) etc.
- We thank the useful discussions with Prof. Yao Guo (PKU) on Fastbot.
- We want to express our gratitude to Prof. Zhenhua Li (THU), Dr. Liangyi Gong (THU) and Prof. Ting Su (East China Normal University) for their helpful opinions on Fastbot.
- We are also grateful for valuable advices from Prof. Jian Zhang (Chinese Academy of Sciences).
Publications
If you use our work in your research, please kindly cite us as:
- Lv, Zhengwei, Chao Peng, Zhao Zhang, Ting Su, Kai Liu, Ping Yang (2022). “Fastbot2: Reusable Automated Model-based GUI Testing for Android Enhanced by Reinforcement Learning”. In proceedings of the 37th IEEE/ACM International Conference on Automated Software Engineering (ASE 2022). ACM, To appear. [pdf]
@inproceedings{fastbot2,
title={Fastbot2: Reusable Automated Model-based GUI Testing for Android Enhanced by Reinforcement Learning},
author={Lv, Zhengwei and Peng, Chao and Zhang, Zhao and Su, Ting and Liu, Kai and Yang, Ping},
booktitle={Proceedings of the 37th IEEE/ACM International Conference on Automated Software Engineering (ASE 2022)},
year={2022}
}
- Peng, Chao, Zhao Zhang, Zhengwei Lv, Ping Yang (2022). “MUBot: Learning to Test Large-Scale Commercial Android Apps like a Human”. In proceedings of the 38th International Conference on Software Maintenance and Evolution (ICSME 2022). IEEE, To appear. [pdf]
@inproceedings{mubot,
title={MUBot: Learning to Test Large-Scale Commercial Android Apps like a Human},
author={Peng, Chao and Zhang, Zhao and Lv, Zhengwei and Yang, Ping},
booktitle={Proceedings of the 38th International Conference on Software Maintenance and Evolution (ICSME 2022)},
year={2022}
}
- Cai, Tianqin, Zhao Zhang, and Ping Yang. “Fastbot: A Multi-Agent Model-Based Test Generation System”. In Proceedings of the IEEE/ACM 1st International Conference on Automation of Software Test. 2020. [pdf]
@inproceedings{fastbot,
title={Fastbot: A Multi-Agent Model-Based Test Generation System},
author={Cai, Tianqin and Zhang, Zhao and Yang, Ping},
booktitle={Proceedings of the IEEE/ACM 1st International Conference on Automation of Software Test},
pages={93--96},
year={2020}
}