Skip to content

FlyingPumba/evolutiz

Repository files navigation

Evolutiz

Environment Configration

  • Python: 2.7

  • Android SDK: API 19

  • Linux: sudo apt-get install libfreetype6-dev libxml2-dev libxslt1-dev python-dev

  • Mac OS: brew install coreutils for gtimeout

Install Python dependencies:

sudo pip install -r requirements.txt

Usage

python main.py <apk_path | source_folder_path>

where apk_path is path to the subject apk under test
or you can specify source_folder_path for the subject app with source code

Subject Requirement:

  • instrumented apk should be compiled and named with suffix "-debug.apk"
  • closed-source/non-instrumented apk name should end with ".apk"

Settings

  • ANDROID_HOME and WORKING_DIR in settings.py should be set before starting Evolutiz.

Output

  • for open-sourced apps, outputs are stored under the given source folder
  • for closed-sourced apps, output are stored under <apk_file_path>_output

Output content:

/coverages - Coverage reports are stored here

/crashes - Crash reports and corresponding test cases that lead to the crashes 
(and also recorded videos files when using real devices)

/intermediate - Generated test event sequences for each generation; logbook of the genetic evolution; 
and line charts showing the variation trend for each objectives.

Notes

  • This implementation has been tested with Android 4.4, running on Ubuntu 14.04 and Mac OS 10.10
  • If measure statement coverage for open-sourced apps, the subjects need to be processed to support EMMA instrumentation: (Please refer to Dynodroid https://code.google.com/archive/p/dyno-droid/)
  • This version is ready for emulators. It also supports real devices, you may need to adapt related code for your specific devices.

Contact

iarcuschin at dc.uba.ar