The information on this page is out of date. Many new features are now available including the creation of custom builds.
This document offers information about the Ant script used to "build" and package the Fluid components.
Overview: What the script can do
- Minifies CSS files.
- Produces a distribution package directory structure and a ZIP file.
How to use the script
- creates a ZIP file of all of the above.
- deletes the build and dist directories from the filesystem.
- Note: a "clean" is done during the buildall process as well.
How to change the release version
Edit the value for fluid_version in the
<\!-\- the Fluid version number \-->
fluid_version = 0.3
Fluid components dependency
To accomplish the correct order for concatenating Fluid files, there is a property in
build.properties that tells the ant script the sequence to process the files
<!-- Order of dependencies -->
As dependencies are added to Fluid component source files, the
order_of_dependencies property should be updated.
How the script works
This is a more detailed description on how the Ant script works. It may be easier for you to look at the script first as it is well documented.
The build script creates two directories:
/dist is where the final output will be, which includes the minified, concatenated, and zipped files.
/build is a directory used by the script for manipulating files before it is output to the
The concatenation process works by performing the Ant concatenation task in the order specified by the
order_of_dependencies variable in the
build.properties file. The source files are located in the
src/webapp/fluid-components/js/fluid/ directory and concatenated together and that file output to:
Before the distribution is created, all necessary files for the distribution package will be copied into the /build directory. The script will then generate 2 distribution packages:
dist/ - A directory structure containing the files required to use Fluid.
dist/fluid-X.zip - a compressed file of the above directory.
Building a WAR file
Currently the script does not build a .war file automatically. To build a .war file manually, execute
/build/war/ directory. This will create a .war file inside your local Maven2 repository.
"Building Web Applications with Apache's Ant" by Julien Lecomte
"Adding JS/CSS compression and JS validation..." at henke.ws