Back to > Overview > DevelopersGuide

The build structures

Authors:
	Remus Pereni <remus@nolimits.ro>
	Antal Attila <atech@nolimits.ro>

Table of Contents

1. Introduction
2. Using Ant
3. Targets
    3.1. Compiling
    3.2. Generating the packages
    3.3. Documentation
    3.4. Testing
    3.5. Cleaning
    3.6. Distribution

1. Introduction

For building all types of applications, and to save a lot of time for this, we using an entire building application named Ant. In the $MN8_HOME/tools/bin/ directory you can find this utility. The mn8 source distributions comes readi to be builded, you need no aditional packages, just say ./tools/bin/ant target from the $MN8_HOME directory.

2. Using Ant

In the base of the build staying a buld.xml file. This file contains groups (targets) of commands. Those commands executes all things for build a needed application

Lanching the build is wery simple, only type in the command line the following:

tools/bin/ant target

What`s meaning the target you can see in the following chapter.

When want's to make build under Windows '98 you may get an error message: Out of environment space To resolve this problem you must edit the config.sys file and put in the following line:

SHELL={WINDIR}/command.com /P /E:1024

Where the WINDIR is the Windows directory (ex. c:\windows)

3. Targets

3.1. Compiling

This steps only compiles the source codes.

compile - compile all java files
antlr - compile the ANTLR grammatical files to java

3.2. Generating the packages

Here we have two special steps, other than jar, for obtaining the special Avalon packages.

jar - builds all the jar files

3.3. Documentation

Steps to generate different documentations.

javadocs - builds the java API interface
xdocs - builds documentation from /src/xdocs
docs - builts all the documentation including the main target

3.4. Testing

Run the unit test, and you have problems the build is breaking down. For informations consult the log file from the logs directory

run-tests - runs all the unit tests

3.5. Cleaning

You make changes but is not taking effect, the problem is you need to clean the old builds.

clean - delete the build directory
clean-all - delete the build, apps, ext, logs directories. Remains only the source distribution codes

3.6. Distribution

Making distributions you can get all. Remamber: before this run the tests.

dist - building only the binary distribution in the dist directory, unarchived, unpacked
src-dist - building only the source distribution in the dist directory, unarchived, unpacked
distributions - building all the binary distributions, archived, packed (.tar.gz) in the dist directory