StoryDroid/StoryDistiller

We have made the source code publicly available. We hope this project can benefit other researchers or practiontiners in the field of analysis of Android apps. Please feel free to contact us (senchen@tju.edu.cn) if you have any questions and issues. We will continue to maintain this project. Thanks for your feedback.

Environment Configuration

• Ubuntu/Macbook
• Python: 2.7
• APKTool: 2.6.1 (Please use the newest version of APKTool)
• Android emulator：X86, Android 7.1.1, Google APIs, 1920 * 1080
• Android environment: adb, aapt
• Java environment (jdk): jdk1.8.0_45
• pip install opencv-python==3.4.3.18
• IC3: https://github.com/siis/ic3, please take the tool into the path /StoryDroid/main-folder/
• jadx: https://github.com/skylot/jadx, please take the tool into the path /StoryDroid/main-folder/
• libs support: Please take the android.jar files of all the different platform versions (android-3~android-32) into the path /StoryDroid/main-folder/config/libs/android-platforms/
• Open ~/.bashrc and configure the path of JDK and SDK (Replace by your own paths):

export JAVA_HOME=/usr/lib/jvm/jdk1.8.0_45
export JAVA_BIN=/usr/lib/jvm/jdk1.8.0_45/bin
export CLASSPATH=.:${JAVA_HOME}/lib/dt.jar:${JAVA_HOME}/lib/tools.jar
export PATH=$PATH:${JAVA_HOME}/bin
export PATH=$PATH:/home/dell/Android/Sdk/tools
export PATH=$PATH:/home/dell/Android/Sdk/platform-tools
export PATH=$PATH:/home/dell/Android/Sdk/emulator
export JAVA_HOME JAVA_BIN CLASSPATH PATH 

StoryDroid/StoryDistiller Usage

• If you want to use the full function of StoryDroid, please use the following command:

python2.7 main_full.py

• If you want to use the fuction of atg (Activity transition graph) generation, please the following command:

python2.7 main_partial.py

StoryDroid+

StoryDroid+ provides an operation-friendly platform for using storyboards and helps different stakeholders (e.g., designers, package managers, developers) explore and understand apps from different perspectives through rich visual pages.

Configuration

• The Environment Configuration of StoryDroid+ is the same as that of StoryDroid/StoryDistiller.
• StoryDroid+ uses Flask framework to build an offline website, a lightweight customizable framework, written in Python, which is more flexible and secure. So:

pip install flask

StoryDroid+ Usage

The folder "code-for-web-v2.0" is the latest version of StoryDroid+, in which the folder "templates" contains the front-end code of StoryDroid+, and the folder "static" contains the resource files of StoryDroid+. If you want to use the full function of StoryDroid+, please use the following command:

python2.7 test.py

Contact

Sen Chen All Copyright Reserved.