You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The *Android Merge Tool (AMT)* does what the name suggests: it merges arbitrary Android apps into a single merged app.
9
+
As input it takes a number of Android packages (.apk files) and outputs the merged app as one Android package.
10
+
Along with this primary output, a report is generated optionally.
11
+
It contains information about the properties (e.g. taint-flows) changed.
12
+
13
+
<palign="center">
14
+
<img src="overview.png" width="75%" />
15
+
</p>
16
+
17
+
An overview of the whole approach is illustrated in the figure above.
18
+
On the one hand, the first five steps (1 - 5) represent *Phase I*, the app merging process.
19
+
Multiple input apps are merged into a single merged app.
20
+
On the other hand, Step 6 and 7 stand for *Phase II*.
21
+
During this phase it is evaluated how accurately the merged app represents the input apps.
22
+
In order to guarantee accurately merged benchmarks Phase II becomes indispensable.
23
+
For more information please take a look at the associated [paper](t.b.a.) (see Publications).
24
+
25
+
## Usage
26
+
Two steps have to be completed in order to use AMT:
27
+
-**Step 1: Configuration**
28
+
The file *amt.properties* holds the AMT's configuration.
29
+
The following options can be configured:
30
+
31
+
| Parameter | Meaning |
32
+
| --------- | ------- |
33
+
|`androidPlatforms=/path/to/Android/sdks/platforms`| The path to the Android platforms directory |
34
+
|`apktoolPath=/path/to/apktool`|[ApkTool](https://github.com/iBotPeaches/Apktool) must be installed and this path has to point to the directory containing ApkTool's JAR file |
35
+
|`apktoolJar=apktool_2.3.4.jar`| Mostly dependent on ApkTool's version, the JAR's filename should be adapted here. |
36
+
|`aqlQuery=Flows IN App('%APP_APK%') USES 'FlowDroid' ?`| When run in *check* or *comparison* mode, an [AQL-Query](https://github.com/FoelliX/AQL-System/wiki/Questions) to execute must be defined here. |
37
+
|`comparisonAqlQuery=Flows IN App('%APP_APK%' \| 'COMBINE') USES 'FlowDroid' ?`| The query used for the comparison must be defined here. |
38
+
|`outputFolder=output`| Any output is stored in the specified directory |
39
+
40
+
-**Step 2: Launch**
41
+
AMT can be accessed from the command-line as follows:
42
+
````bash
43
+
java -jar AMT-0.0.2.jar [optional launch parameters] [list of .apk files]
44
+
````
45
+
for example:
46
+
````bash
47
+
java -jar AMT-0.0.2.jar -comparison -d short -cfg myConfig.xml A.apk B.apk
48
+
````
49
+
This will launch AMT in comparison mode, shorten its output and use `myConfig.xml` as configuration for the underlying AQL-System.
50
+
All launch parameters are listed in the following table:
51
+
52
+
| Parameter | Meaning |
53
+
| --------- | ------- |
54
+
|`-check`| Turns on the optional *check* mode |
55
+
|`-comparison`| Turns on the optional *comparison* mode |
56
+
|`-c %FILE%`, `-cfg %FILE%`, `-config %FILE%`| This parameter can be used to specify a different config file for the underlying [AQL-System](https://github.com/FoelliX/AQL-System) (By default: *config.xml* is used) |
57
+
|`-debug "X"`, `-d "X"`| The output generated during the execution of this tool can be set to different levels. `X` may be set to: `error`, `warning`, `normal`, `debug`, `detailed` (ascending precision from left to right). Additionally it can be set to `short`, the output will then be equal to `normal` but shorter at some points. By default it is set to `normal`. |
58
+
59
+
## Publications
60
+
-*App Merging for Benchmark Speed-Up and Analysis Lift-Up* (Felix Pauck, Shikun Zhang)
61
+
t.b.a.
62
+
63
+
## License
64
+
AMT is licensed under the *GNU General Public License v3* (see [LICENSE](https://github.com/FoelliX/AMT/blob/master/LICENSE)).
0 commit comments