PreEmptive Protection™ DashO™ for Android & Java's Ant tasks are in ant-dasho.jar. This jar must be integrated with Ant. An optional configuration step can be performed before this to make the use of DashO's tasks easier.
Note: When you update DashO, you need to also update the jar used by Ant.
Configuring dasho.ant.runtime.properties
As discussed in Setting DashO Home the Ant tasks need to know where DashO is installed. One of the options is to set the value in a properties file stored in ant-dasho.jar. Setting the home value this way lets buildfiles run with minimum configuration. It is not required that this file be configured as there are other ways to specify where DashO is installed.
To see the values that the task will use you can run the antconfig script:
C:>antconfig show dasho.home=C:/Program Files/PreEmptive Protection DashO x.y/app dasho.fullVersion=x.y.z dasho.version=x.y
If the value returned for dasho.home is correct your configuration is complete. If you have installed DashO in another directory you will need to specify a new location. The simplest method is to let the value be configured automatically:
C:>antconfig dasho.home=C:\Documents and Settings\lazardo\DashO x.y\app
If the value cannot be determined automatically, you can specify it:
C:>antconfig C:\Documents and Settings\lazardo\some\directory does not contain DashOPro.jar C:>antconfig "C:\Program Files\PreEmptive Protection DashO x.y\app" dasho.home=C:\Program Files\PreEmptive Protection DashO x.y\app
Note: Paths that contain spaces must be quoted.
Where to install the tasks
Ant can find tasks stored in one of two locations:
- ant.lib directory - tasks placed in this directory are accessible to all users of Ant.
- USER_HOME/.ant/lib directory - tasks found here are available to a single user.
You can determine these locations by running Ant for the command line - be prepared for lots of output!
C:>ant -diagnostics ... ------------------------------------------- ANT_HOME/lib jar listing ------------------------------------------- ant.home: C:\Program Files\apache-ant-1.9.9 ... ------------------------------------------- USER_HOME/.ant/lib jar listing ------------------------------------------- user.home: C:\Documents and Settings\lazardo ...
This means that the two choices for installing the task are C:\Program Files\apache-ant-1.9.9 and C:\Documents and Settings\lazardo\.ant.
Installing the tasks
Once you have chosen the installation directory you can use the antinstall script to install the Ant tasks:
C:>antinstall "C:\Documents and Settings\lazardo\.ant" Creating C:\Documents and Settings\lazardo\.ant Creating C:\Documents and Settings\lazardo\.ant\lib Copying ant-dasho.jar to C:\Documents and Settings\lazardo\.ant\lib Installation complete
Note: Paths that contain spaces must be quoted.
Installing the tasks into Eclipse
If you chose to install the Ant tasks in your USER_HOME/.ant your configuration is complete - Eclipse will discover the jar stored here and add it to the classpath of its internal version of Ant. Otherwise you need to tell Eclipse to add the jar to Ant's classpath via Eclipse's preferences:
- Open Eclipse's Preferences dialog using Window > Preferences… from the menu bar.
- Use the navigation tree to go to Ant > Runtime. The dialog will look something like this:
- Select Global Entries and then click on Add External Jars….
- Use the file selector to go to where DashO has been installed and add ant-dasho.jar.
The resulting dialog will look something like this:
- Click on Apply and Close to save the changes.
Eclipse configuration is complete.