ssk97 / PUMA

Programmable UI-Automation Framework for Dynamic App Analysis

PUMA

Programmable UI-Automation Framework for Dynamic App Analysis

Project Details

PUMA was developed by Shuai Hao in collaboration with Bin Liu, William G.J. Halfond, Ramesh Govindan at USC and Suman Nath at MSR. A thorough description of PUMA can be found at the Networked Systems Lab project page for PUMA. Any technical questions can be directed to [e-mail].

Running PUMA

• First of all, environment variables like JAVA_HOME and ANDROID_HOME should be set up properly. Optional: You can setup the ANT_HOME for the ant build package location;
• Downalod latest Eclipse and then Import the Project (clone this repo to your locally)
  • Install Git bash if you Running on Windows
• Make sure the following line is configured point to your local SDK location
  • For Windows sdk.dir=C:/Users/{username}/AppData/Local/Android/Sdk
• Update your local SDK with some legacy dependcy.
  • copy everything from this Folder to your SDK location /Users/{UserName}/Library/Android/sdk/tools
• Make sure your SDK have Android SDK 18 installed
• After succesfully get everything configured. you should able to using Eclipse's "add ant build by search" function to add all the existing build.xml build method to the Ant build tool window.
• Then you will need run clean, compile and build under the Ant tool window.

To run the "app under study", you need to find out the package name and text label for the app. e.g. com.abc.apk will have com.abc as package name. "label" will be the text shown after installing it on phone.

• replace app.info file with above information in two lines
• ./setup-phone.sh // it will list a file "haos"
  • for Windows system please use: setup-phone-windows.bat
• ./run.sh // start monkey execution
  • for Windows system please use: run-windows.sh

Note that PUMA is currently instantiated for Android platform and only tested on Ubuntu machine (12.04), Android 4.3. Users may require proper Android development environment setup before using PUMA. We are adding some automated procedure to check such environment before running PUMA.

Some Useful adb tips

Note: You will have to have SDK in your path before you can call adb command

Show list of devices and its id

adb devices

Perform any action against specific device (USB or Emulator) Not needed if only one device connected:

adb -s {deviceID} [Action]

install package using adb

adb -s {deviceID} install /paht/to/something.apk

list all installed packages for some device

adb -s {deviceID} shell pm list packages

uninstall certain packages

adb -s {deviceID} shell pm uninstall com.example.package