This section refers to the XAP build system. If you simply want to use XAP within your web application you can skip this page. If you would like to modify the XAP code or create custom XAP profiles, read on.
Installing XAP
To install XAP, you must perform the following major steps. See below for details on each step.
- Install prerequisites
- Download the XAP source
- Build XAP
- Deploy to a Web server
Installing Prerequisites
In order to use the build system of XAP you'll need:
- Java 2 Standard Edition (J2SE) Java Development Kit (JDK)
- Apache Ant
- A web server (for example, Apache Web Server)
- Perl (optional: used for generating the documentation)
Installing a Java Development Kit (JDK)
The XAP build requires Sun J2SE JDK 5 (1.5).
To download the latest Sun J2SE JDK 5 (1.5):
- Go to: java.sun.com.
- Locate and select J2SE 5.0.
- Look for the JDK 5.0 Update (Latest) banner.
- Click Download JDK 5.0 (Latest) to install it on your development system. Note: This installer includes JS2E Runtime Environment 5.0.
Installing Apache Ant
Install Apache Ant (1.6.1 or greater) to use the build system.
To install Apache Ant:
- Download and install Ant from ant.apache.org.
- Follow instructions for installing Apache Ant available in the manual.
Important Notes
Note for Windows users:
The XAP build system requires the ant bin directory to be in your path -or - ANT_HOME to be defined. From the command line: set PATH=%PATH%;"C:\Program Files\Ant\bin" - or right click on My Computer, choose Advanced and click Environment Variables.
Note for Linux and Unix users:
The build scripts require manually editing of the exec function to work properly. This is a known issue that we are working to resolve.
Installing a Web Server
Deploying the XAP source and example code requires a web server such as Apache web server available at http://httpd.apache.org/.
Follow your Web server's instructions to perform a typical installation of the Web server on your local system.
Installing Perl (Optional)
Perl is used with JSDoc to create documentation from the JavaScript source file. If you are on a Windows system you will need to download Perl from http://activeperl.com/. Note: If JSDoc informs you that you are missing a library, see JSDoc homepage for the appropriate instructions.
Downloading the Source
Download the XAP source from the XAP subversion repository: https://svn.apache.org/repos/asf/incubator/xap
Versions available:
Wiki Markup Head \[Active development\]: https://svn.apache.org/repos/asf/incubator/xap/trunk
Wiki Markup Milestone 2 \[tagged Aug 25, 2006\]: http://svn.apache.org/repos/asf/incubator/xap/tags/milestone2 Warning: The head version is under active development. \\
Building XAP
To build XAP, use the XAP build scripts.
The XAP build scripts provide the following directives:
Directive | Result |
tests | Runs the JSUnit tests. You will need to modify the jsunit-server-properties.xml to point to your web browser of choice. |
deploy-examples | Deploys examples without rebuilding profile. |
examples | Rebuilds profile and redeploys examples. |
build-profile | Compresses based on a profile in buildscripts/profiles. |
doc | Builds the documentation. |
compile-tools | Compiles the JAR needed for source compression. |
compress-source | Compresses all system JS files and places the output in \compressedSource. |
all | Runs all directives. |
To view a list of the build directives, at a command prompt:
- Navigate to the root directory into which you downloaded XAP. 2. Type: build
The following output appears:
No Format |
---|
help: [echo] [echo] Build script help [echo] This build script requires jdk1.5 for JSUnit [echo] Available targets: [echo] [echo] tests: runs JSUnit tests. You will need to modify [echo] jsunit-server-properties.xml to point to a [echo] browser on your machine. [echo] [echo] deploy-examples: deploys examples without rebuilding profile [echo] usage: ant deploy-examples -DwebappsRoot=[dir] [echo] -DexamplesAppName=[name] [echo] [echo] examples: rebuilds profile and redeploys examples [echo] usage: ant examples [echo] [echo] build-profile: compresses based on a profile in [echo] buildscripts/profiles to a specified directory [echo] usage: ant build-profile -Dprofile=[profile_name] [echo] -Drelease_dir=[dir] [echo] [echo] doc: builds JSDoc to doc/xap directory [echo] [echo] all: runs tests, examples and doc [echo] [echo] help: prints this message [echo] BUILD SUCCESSFUL Total time: 0 seconds |
To build XAP and all of its components, at a command prompt:
- Navigate to the root directory into which you downloaded XAP.
- Type:
No Format |
---|
build all |
To build the sample files only, at a command prompt, type:
No Format |
---|
build examples |
If a message similar to the following appears, you can ignore it:
No Format |
---|
Unable to locate tools.jar. Expected to find it in C:\Program Files\Java\jre1.5.0_08\lib\tools.jar |
This messages indicates that only a JRE is installed on your system and not a JDK. However, for XAP you need a JRE only.
Deploying to a Web Server
After running the build, a \staging directory appears in the XAP directory structure. Copy the contents of the staging directory to your Web server and you will be able to run the example files.
Important Notes
- IIS does not recognize files with a .XAL extension. Add a mime type text/xml handler for this file extension with the IIS configuration.
- By default web browsers cache .XAL files - meaning you won't see changes when you hit refresh. You can work around this by adding a
cache-control: no-cache
HTTP header, either by changing the server configuration or by using a server side script to generate the XAL files.