Chapter 4. Developer guide

Table of Contents

Building from source
Generating the distribution packages
Server component architecture
Portlets architecture

Building from source

The Kosmos build system use a small set of easy-to-understand Ant scripts and property files. There are three actual build-scripts: one for building the server component ( build-server.xml), one for building the portlets (build-portlet.xml) and one for creating the distribution packages (build-distro.xml). The two “real” build scripts use a common template build/build.xml and are configured through the property files in the build directory.

The variable names are self-explanatory and all the targets are well-documented in the appropriate script:

Buildfile: build-portlet.xml
Buildfile: build-portlet.xml
Kosmos Portlet Module build-script
Main targets:

 all       Recompiles all Java source files
 clean     Cleans up temporary files created during previous builds
 compile   Compiles Java source files
 deploy    Deploys the module to the container
 dist-bin  Prepares all binary distributables
 redeploy  Redeploys the module to the container
 undeploy  Undeploys the module from the container
Default target: redeploy

For instance, recompiling the full source code is simply:

ant -f build-portlet.xml all

Please study the scripts themselves for further details.