A path map file specifies the directories or JARs that PreEmptive Protection™ DashO™ should process and the corresponding output locations where DashO writes the processed classes. It also specifies directories or JARs on which the inputs depend.
Top-Level Object
The path map format consists of a JSON object:
{
"version": "2.0",
"entries": [
{
"input": "C:\\test\\app-classes.jar",
"output": "C:\\test\\out\\app-classes-processed.jar",
"name": "app-classes",
"scopes": [ "PROJECT" ]
},
{
"input": "C:\\test\\generated-classes\\",
"output": "C:\\test\\out\\generated-classes\\",
"name": "generated-classes",
"scopes": [ "PROJECT" ]
}
],
"dependencies": [
{
"path": "C:\\android\\android.jar",
"scopes": [ "BOOT" ]
},
{
"path": "C:\\test\\lib.jar",
"name": "lib-jar",
"scopes": [ "EXTERNAL_LIBRARIES" ]
}
]
}The top-level object contains these properties:
| Property | Requirement and description |
|---|---|
version |
Required string. A string representation of a number describing the Path Map format version. This DashO version supports only "2.0". |
entries |
Required array of entries. These describe DashO's inputs and their corresponding outputs. |
dependencies |
Required array of dependencies. These are input dependencies that DashO does not treat as inputs. |
Entries
Entries describe inputs and their corresponding output locations.
| Property | Requirement and description |
input |
Required string. Path to the input DashO processes. |
output |
Required string. Path where DashO writes the entry's processed classes. |
name |
Optional string. Friendly name for the input, used for display in the DashO GUI. |
scopes |
Optional array of strings. Describes the entry's relationship to the project, for example PROJECT for project classes. |
Relative paths in input or output are resolved relative to the Path Map file. DashO issues an error if an input file or directory is missing, but attempts to create parent directories for an output file if they do not exist.
In the example, the classes in C:\test\app-classes.jar are output to C:\test\out\app-classes-processed.jar after processing. Outputs match their inputs: an input JAR produces an output JAR, and an input directory produces an output directory.
Dependencies
Dependencies describe JARs and directories that are not treated as inputs to DashO but contain classes referenced by inputs specified in entries.
| Property | Requirement and description |
|---|---|
path |
Required string. Path to the JAR or directory. |
name |
Optional string. Friendly name for the dependency, used for display in the DashO GUI. |
scopes |
Optional array of strings. Describes the dependency's relationship to the project, for example BOOT for the Android SDK JAR and other core classes that would not be packaged in an Android application. |