[[TracNav]]
= Build and Packaging Instructions =

The simplest way to build T3Q and T3D is by using Eclipse. Check out the sources from the repository in an Eclipse project and build them using the Eclipse functionalities. The projects will require the TRex Core project and the T3Tools common project. These dependencies are recommended but can be circumvented by excluding them from the build path, in which case the prepackaged components will be used (which adds certain limitations and is not recommended for development).

Another way to build the tools is by using Apache ANT. This has the added benefit that build operations can be scheduled and performed automatically at a given time. The included {{{build.xml}}} (which is also serving as a basis for the Eclipse build functionalities) provides the necessary configurations. In case the T3Tools common components project needs to be built as well, it will have to be built first and then copied to the {{{lib}}} folder.

{{{
ant compile
ant make-dist
}}}

shall suffice for building the T3Tools Common Components package. Same applies for the TRex Core project. Building the TRex Core project is slightly more complicated. It requires an ANTLRv2 distribution, which shall be available in the shell / CLI path in order to build the grammars. Building the grammars has to be performed by using the supplied {{{buildgrammars}}} shell script (samples are available for both Windows ({{{.cmd-sample}}}) and Unix {{{.sh-sample}}} based systems). The scripts will need to be adapted by setting the correct workspace location (where the TRex Core project is located)) in the {{{WORKSPACE_PATH}}} variable, e.g. {{{/TEMP/workspace}}}. After the grammars are built, either Eclipse or ANT can be used to build the TRex Core project.

To build an installation package for the tools, use the {{{nsis}}} ANT target (optionally performing a clean up prior to that):

{{{
ant clean
ant nsis
}}}