A python library for writing automatic UI testing tools.
This module is a replacement for the Jython monkeyrunner library that comes with the Android SDK.
The monkeyrunner module is (almost) a drop-in replacement for the com.android.monkeyrunner
Jython module. There is an issue with python 2 vs 3 language compatibility. The Jython
interpreter shipped with the android SDK is quite old, it supports python 2.5.3.
This python version does not have any of tbe future compatibility features which came with
v2.6 and v2.7. This makes writing code which works both on python 3.x and in the Jython
environnent a bit more difficult. Mostly this means, you can not use the print function,
and you will have to use sys.exc_info() to access the most recent exception.
To be able to use this module, create a subdirectory com/android, and put a symbolic link
to the monkeyrunner.py file there.
Then run your monkey script using:
python3 mymonkey.py
monkeyrunner is an Android SDK tool which runs Jython scripts in a context which provides access to various device resources.
- monkeyrunner documentation
- MonkeyDevice for installing, launching and interacting with apps.
- MonkeyImage for screenshots.
- MonkeyRunner
Google sourcecode:
monkeyrunner uses two tools on the device to accomplish it's tasks: adb and monkey.
To execute a Jython monkeyrunner script, type:
$ANDROID_HOME/tools/bin/monkeyrunner mymonkey.py
monkey is the tool running on the device providing the UI interaction support for monkeyrunner.
- monkey documentation
As a standalone tool it can also be used to monkey-test a ui, by sending random taps to it.
Google sourcecode:
adb is the tool for all developer interactions with android devices,
- SERVICES.TXT has a list of all supported commands.
- adb sourcecode
Willem Hengeveld [email protected]