Software Compiling and Running RERAN

Getting started with RERAN is easy. The instructions below assume you have the Android SDK installed on your computer (runs on Linux, Mac, and Windows). We use the adb debugging bridge to push files onto the phone and run the record and replay commands. The ./adb tool is in the /platform-tools folder of the SDK folder you install. The example below performs our standard record and replay. For the selective replay and time-warping features, please see their respective pages.

RERAN Design

First, recording with getevent will create a log of the events used during the run, e.g., recordedEvents.txt. Second, send the recorded log into the Translate program. The Translate program will output a translated log of the original events. Third, push the translated log, e.g., translatedEvents.txt, onto the phone. Fourth, run the Replay program using the adb shell.

Compiling RERAN

We have designed and implemented RERAN to work on any Android phone. The cross-compiled executable contained in the download .zip should work on any phone running an ARM CPU. But if you are having troubles with the executable or want to extend RERAN yourself, feel free to do so. Otherwise, if you want to jump right in, download RERAN, and move on to the Running Example.

The RERAN source code is located on GitHub: here.

ARM Cross-compiler

In order for the replay program to run on Android devices, they must be compiled using a cross-compiler for ARM CPU's. If you already have an ARM cross-compiler on your computer, then you are ready to go. If not, please find one that works with your operating system. The executable contained in our release was compiled on Linux. From our experience, finding and installing an ARM cross-compiler for Mac was difficult; it is possible, but included many hacks to get going, and is not recommended.

We would recommend using Sourcery CodeBench for ARM Lite on Linux. After the ARM cross-compiler is installed, you can compile the source code using the compiler's version of gcc, shown below.

  arm-none-linux-gnueabi-gcc -static -o replay.exe replay.c

Running Example

Push replay tool onto the phone: "/data/local" will be our local directory on the phone for the RERAN files. If it does not exist, it will be created. This step only needs to be done once.

    cd /path/to/android-sdk/platform-tools
    ./adb push ./replay.exe /data/local

Record a trace: The getevent tool is part of the Android SDK. The "-tt" flag is to timestamp each event (used by the Translator in the next step).

    ./adb shell getevent -tt > recordedEvents.txt

Run the Translate program: The first two arguments of the Translate program are the path to the recorded events and the name of the translated events to output, respectively. There are also extra flags: see selective replay and time-warping.

    cd /path/to/translate.jar/
    java -jar translate.jar /path/to/recordedEvents.txt /path/to/android-sdk/platform-tools/translatedEvents.txt

Push the translated recorded events onto the phone:

    cd /path/to/android-sdk/platform-tools
    ./adb push translatedEvents.txt /data/local

Run the replay program (after your app is setup): See setting up your app for more info.

    ./adb shell /data/local/./replay.exe /data/local/translatedEvents.txt

Download RERAN
Number of Downloads: 5323
Contains the Replay cross-compiled executable
and the Translate jar file. See Software for usage. No compile needed.

Download Paper
ICSE 2013

For questions or feedback:
info (at) androidreran (dot) com