Author: Gelin Jiofack Nguedong Gerrit Schelter Magnus Halbe Philipp Staudt Sven Stauden Timo Speith Tobias Sander

Introduction

DroidMateGUI is an front-end for the GUI test generator DroidMate.

This file pertains to DroidMateGUI source. You should have found it at DroidMateGUI repository root dir.

The repository address:

https://se.st.cs.uni-saarland.de/web-front-end-for-android-gui-test-generator.git

This file is part of the “DroidMateGUI” project.

This file explains:

• How DroidMateGUI works.
• How to build and test DroidMateGUI.
• How to setup an IDE for development.

How DroidMateGUI works

DroidMateGUI connects to DroidMate application and provides multiple .apk files for exploration which have previously been selected by the user. It reads DroidMates` output via stdout and visualizes it in realtime in the browser.

As input, DroidMateGUI takes a folder containing .apk files for testing. This folder can be selected by the user in the browser in which DroidMateGUI runs. After folder selection, DroidMateGUI passes the file path of the selected files to DroidMate for processing.

Building and testing DroidMateGUI

DroidMateGUI is built as a .war using e.g. an IDE like eclipse EE and maven (http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/mars1).

First build (just after cloning from repo)

To build DroidMateGUI for first time, follow these steps:

1. Setup the dependencies

1. Install Java Development Kit (JDK) 8.

2. Install Tomcat 8.0

3. Install Android SDK

4. Install Eclipse EE

5. Set up DroidMate

2. Do the build

1. Import the project in Eclipse as an maven project.

2. Setup a Tomcat Server in Eclipse (Window->Preferences->Server->Runtime Environment->Add) by selecting a Apache Tomcat Server 8.0 and set the path to the installed Tomcat 8.0 directory.

3. Install maven dependencies via maven update and maven install.

4. Set the JDK 8 runtime environment (Properties -> Java Build Path -> Change the current JRE to the JDK or add it)

5. Build the .war file by File->Export->WAR File

6. Place the .war file in your apache-tomcat-folder\webapps\ folder.

7. Go to apache-tomcat-folder\bin and start startup.bat with administrator rights.

8. Visit the url: http://localhost.com:8080/DroidMate/Index

9. Configure DroidMate Path and reports path in the settings (http://localhost.com:8080/DroidMate/Settings).

10. Configure Android-SDK AAPT build tool path in the settings (http://localhost.com:8080/DroidMate/Settings).

Dependencies

see pom.xml in project root directory for dependencies.

DroidMate project with DroidMateGUI hooks: https://github.com/rumpelheinz/droidmate