Difference between revisions of "Higgins2Ant"

Revision as of 08:54, 22 March 2008

{{#eclipseproject:technology.higgins}}

Introduction

higgins2ant is an Eclipse plug-in that the Higgins project uses. It generates dependencies.xml file using information about particular project from Eclipse IDE. This information includes classpath information and plugin dependency information from either plugin.xml or manifest. In some cases it could be even more complex - only Eclipse IDE could gather all required classpath information correctly.

Prerequisites

A number of prerequisites need to be installed on the build machine, as follows:

1. J2SE 1.4.2
2. Eclipse version 3.2 of higher
3. Ant version 1.6.5 or higher

General Information

build.xml

The build.xml file is an Ant script that is created by the higgins2ant to take your java project/plug-in/feature components and combine them into a deployable format. This file compiles and archives your plug-in source code into a single JAR file.

Targets for java project

Targets for plugin project

Targets for feature project

project.psf

dependencies.xml

dependencies.xml provides the build process with information on required projects and/or libraries.

Build scripts use dependencies.xml file with the structure below as generated by Eclipse IDE.

<?xml version="1.0" encoding="UTF-8"?>
<dependencies id="org.eclipse.higgins.icard.provider.cardspace.common">
	<!-- list of projects that are required -->
    <higginsProjects>
        <project id="org.eclipse.higgins.registry"/>
        <project id="org.eclipse.higgins.icard"/>
    </higginsProjects>
	<!-- libs that should be downloaded to the project. can be multiple for different locations -->
    <remoteLibs location="lib">
        <library id="commons-logging-1.1.jar"/>
        <library id="serializer.jar"/>
        <library id="xalan.jar"/>
        <library id="xercesImpl.jar"/>
        <library id="xmlsec-1.4.0.jar"/>
    </remoteLibs>
</dependencies>

Setup

With the prerequisites installed, follow these steps to setup your environment:

1. Add the jre/bin directory of the installed JDK to your PATH environment variable.
2. Add the ant/bin directory of the installed Ant to your PATH environment variable.

At last, you must install higgins2ant plugin. It can be installed by 2 ways:

• setup locally
• setup on-line

Setup locally

Setup on-line

Generate files

Run build files

Run build file for java project

Run build file for plugin project

Run build file for feature project

Uninstall

See Also