Ant for eclipse - access eclipse configurations from within ant

<userLibraries>

Scope: Java Projects

Description

The userLibraries type allows you to create an ant path instances from an eclipse user libraries configuration. This is neccessary if you use libraries in your classpathes that must be resolved by ant4eclipse.

The reads an exported user libraries definition file and creates an appropriate path instance for each defined library, containing all pathes of the library. The created path instances gets an id assigned that follows the naming schema 'org.eclipse.jdt.USER_LIBRARY/name of the library'.

To use this type, you first have to export the userdefined libraries from eclipse: to do so, use the "Export..."-Feature in the preference dialog ("Window->Preferences...", then "Java->Build Path->User Libraries"). The outfile can easily included in your buildfile by using this type.

This way these entries can be resolved and used by the other Ant4Eclipse tasks.

Arguments

Argument	Description	Required
userlibraries	Location of an eclipse userlibraries export file.	yes

Example

To import user libraries file "myUserLibararies.xml" that has been exported by eclipse previously:

	
 <project name="..." default="...">
  
   <userLibraries userlibraries="${basedir}/../myUserLibararies.xml"/>
 </project>

Imagine the file mentioned would contain a libary called "JUNIT" that consists of one path "/usr/local/junit/junit.jar", a path with the ref-id "org.eclipse.jdt.USER_LIBRARY/JUNIT" would be created:

	
 <project name="..." default="...">
  
  <userLibraries userlibraries="${basedir}/../myUserLibararies.xml"/>

  <target name="...">
   <property name="junit-path.txt" 
             refid="org.eclipse.jdt.USER_LIBRARY/JUNIT"/>
   <echo>Using JUNIT: ${junit-path.txt}</echo>
  </target>
	
 </project>