DASCA
/
DASCA
2
1
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Updated cloning instructions.

This commit is contained in:
Achim D. Brucker 2018-10-26 23:01:13 +01:00
parent 41748b3c54
commit 9b004207b2
1 changed files with 15 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
README.md
View File

@ -1,6 +1,9 @@
# DASCA # DASCA
## Installation ## Installation
### Prerequisites ### Prerequisites
* Java 8 (Java 9 or later is currently *not* supported) * Java 8 (Java 9 or later is currently *not* supported)
* Android SDK (to obtain dx.jar) * Android SDK (to obtain dx.jar)
* Eclipse Oxygen, including * Eclipse Oxygen, including
@ -14,16 +17,15 @@
### Checkout ### Checkout
Note that this repository imports [WALA](http://wala.sf.net) as a submodule. Thus,
you either need to recursively clone this repository, e.g.,
```
git clone --recursive https://git.logicalhacking.com/DASCA/DASCA.git
```
or execute ``git submodule update --init --recursive`` after
cloning the repository.
The repository can be cloned as usual:
```
git clone https://git.logicalhacking.com/DASCA/DASCA.git
```
### Resolving external dependencies ### Resolving external dependencies
* Ensure that the environment variable `ANDROID_HOME` is set correctly and that * Ensure that the environment variable `ANDROID_HOME` is set correctly and that
the Android SDK has API 19 installed, i.e., the Android SDK has API 19 installed, i.e.,
`${ANDROID_HOME}/platforms/android-19/android.jar` should be a valid path. `${ANDROID_HOME}/platforms/android-19/android.jar` should be a valid path.
@ -36,6 +38,7 @@ mvn install:install-file -Dfile=apktool_2.3.0.jar -DgroupId=apktool -DartifactId
``` ```
### WALA configuration ### WALA configuration
DASCA (and the underlying WALA setup) is tested with Java version 8. DASCA (and the underlying WALA setup) is tested with Java version 8.
If DASCA is installed using Java 8, there should be no need for updating If DASCA is installed using Java 8, there should be no need for updating
the WALA configuration. the WALA configuration.
@ -54,6 +57,7 @@ the `<PATH-TO-JDK>` should point to the directory containing the file
`rt.lib`. `rt.lib`.
### How to Compile ### How to Compile
First check that the variable `JAVA_HOME` is configured correctly, e.g.: First check that the variable `JAVA_HOME` is configured correctly, e.g.:
``` ```
export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64 export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
@ -74,17 +78,21 @@ While some WALA projects may contain compilation errors, all DASCA
projects (i.e., `com.logicalhacking.dasca.*`) should compile without errors. projects (i.e., `com.logicalhacking.dasca.*`) should compile without errors.
## Team ## Team
Main contact: [Achim D. Brucker](http://www.brucker.ch/) Main contact: [Achim D. Brucker](http://www.brucker.ch/)
### Contributors ### Contributors
* Thomas Deuster * Thomas Deuster
* [Michael Herzberg](http://www.dcs.shef.ac.uk/cgi-bin/makeperson?M.Herzberg) * [Michael Herzberg](http://www.dcs.shef.ac.uk/cgi-bin/makeperson?M.Herzberg)
* Tim Herres * Tim Herres
## License ## License
This project is licensed under the Eclipse Public License 1.0. This project is licensed under the Eclipse Public License 1.0.
## Publications ## Publications
* Achim D. Brucker and Michael Herzberg. [On the Static Analysis of * Achim D. Brucker and Michael Herzberg. [On the Static Analysis of
Hybrid Mobile Apps: A Report on the State of Apache Cordova Hybrid Mobile Apps: A Report on the State of Apache Cordova
Nation.](https://www.brucker.ch/bibliography/download/2016/brucker.ea-cordova-security-2016.pdf) Nation.](https://www.brucker.ch/bibliography/download/2016/brucker.ea-cordova-security-2016.pdf)