Building I-Card Manager Application
Asant and Ant
We use script asant, which is located in the J2EE 1.4 SDK bin directory, to build the source code of this application. asant is a wrapper around Ant which is a Java-based build tool like make, which has been developed under the auspices of the Apache Software Foundation. Ant version 1.5.3 and 1.6 beta 1 may also be used to build and deploy the applications.
Note: The I-Card Manager application bundle comes with pre-built binaries. To deploy these binaries and avoid building the application, consult the I-Card Manager installation instructions.
Build I-Card Manager application
This section explains how to build the application binaries for the I-Card Manager application. Building all the application binaries and performing other tasks with Ant involves invoking asant from <higgins_broker.home>/apps/icard directory of the Higgins Broker installation.
Before building the application, you need to configure the <higgins_broker.home>/build.properties file to match your enviroment. You need to set the following properties:
|j2ee.home||The absolute path to the directory where J2EE SDK is installed.||c:\j2sdkee1.4 (on Windows) or /home/mydir/j2sdkee1.4 (on Unix)|
Note: On Windows, while writing the paths in the build.properties files, you need to escape the "\" properly by using "\\" instead. For example, to set j2ee.home to c:\j2sdkee1.4, the entry in the properties file is j2ee.home=c:\\j2sdkee1.4.
To build the application binaries on Unix, open a shell prompt and enter these commands:
To build the application binaries on Windows, open a shell prompt and enter these commands:
For the above command to work, your PATH environment variable must have been set as explained in the I-Card Manager installation instructions and the ANT_HOME environment variable, if any, should not point to any other version of ant that migh be on your system. When asant is invoked without any arguments, all the application binaries are built. The binaries are placed in the following folders:
The following table lists possible arguments when invoking asant :
|core||Builds everything. (This is the default build target.)|
|clean||Cleans out the build output directories.|
|deploy-apps||Deploys the application binaries.|