Look what Java and SIP can do
 (SIP)Java = ∞
Home     News     Projects     Downloads     Support     Contact
GWTCOMP Home
Basics
Installing GWTCOMP

 Using GWTCOMP in your Project

Building from the Sources
References
Javadocs (including examples)


Building GWTCOMP From the Sources


Content:

Pre-Requisite Software

You will need the following software for building GWTCOMP:

  1. Java 2 Standard Edition SDK version 1.5 or above. You can download the SDK from http://java.sun.com/javase/downloads .
  2. Google Web Toolkit Version 4.0 or higher (Note: GWTCOMP will not work with GWT 1.3). You can download GWT from http://code.google.com/webtoolkit/ .
  3. You will need Ant 1.6 or higher. You can download ant from http://ant.apache.org .
  4. Optionally, download the Eclipse IDE from http://www.eclipse.org.
  5. You will need a SVN client if you want to check out the code from the GWTCOMP Subversion repository. You can either use command-line Subversion client, TortoiseSVN or the Eclipse plugin for Subversion - Subclipse.

Top

Downloading and Installing the Source Code

You can download the source code in two ways:
  1. Download the source distribution and unpack the source code as explained here.
  2. Check out the source code from the CafeSip Subversion repository.
Top

Checking out the code from the Subversion Repository

The subversion repository root for the GWTCOMP project is:

https://cafesip.svn.sourceforge.net/svnroot/cafesip/gwt-components

To check-out the latest and greatest code, use the following URL. Note that the code may not be stable.

https://cafesip.svn.sourceforge.net/svnroot/cafesip/gwt-components/trunk

To check out last-known stable version, use the following URL:

https://cafesip.svn.sourceforge.net/svnroot/cafesip/gwt-components/labels/stable

To check out a released version, use the following URL:

https://cafesip.svn.sourceforge.net/svnroot/cafesip/gwt-components/labels/releases/rX.Y.Z
[Replace X.Y.Z with the actual release number].

Check out the Code
Follow the steps below:
  1. Create a directory called "cafesip" under your home directory or anywhere you choose.

    $ mkdir cafesip
    $ cd cafesip

  2. If you are going to use command line Subversion or TortoiseSVN to check out the code, create a sub-directory called gwt-components. You don't need to execute this step if you are going to use the Eclipse SVN plugin - Subsclipse (see below).

    $ mkdir gwt-components

  3. Next, depending on your development environment, follow one of the paths explained below.

If you are not using Eclipse:

Using the SVN command line tool, checkout the code by running the command:

$ svn co URL gwt-components
[Replace the URL with one of the above-mentioned URLs]

If you are not using the SVN command line tool but use TortoiseSVN, you will need to do something similar from the Subversion menu.

If you are using Eclipse:
  1. Make sure you have the latest subclipse plugin installed. You can get the plugin from http://subclipse.tigris.org/ .
  2. From the Eclipse IDE, select menu options Window->Show View->Other.
  3. From the Show View dialog box, select the SVN folder and  select SVN Repository. An empty SVN repository panel will be created and docked into the Eclipse screen.
  4. Select the SVN Repository panel, right click on the panel to bring up the popup menu. Select New->Repository Location.
  5. From the repository dialog box, enter the URL - https://cafesip.svn.sourceforge.net/svnroot/cafesip.
  6. Once the above step is completed, you will see the entire CafeSip source tree on the panel. First select the GWTCOMP project and either choose the trunk or one of the labels as explained above.
  7. Right-click on the directory you selected, from the context menu, select the Checkout option. The Eclipse IDE will contact the repository to gather project information. We have included all the Eclipse project files with the GWTCOMP source code so that the project can be setup easily.
  8. From the Checkout dialog box, select Next. Uncheck the "Use default workspace location". Instead enter the location of the directory where you created the cafesip directory above ($CAFESIP_HOME).  click on the Finish button.
  9. The Eclipse IDE will download the source code and create the project. Depending on your connection speed, the download time will vary. Once the download is completed, you will see the project on the Package Explorer panel.
Top

Building the Source

The root directory of the GWTCOMP project ($CAFESIP_HOME/gwt-components) contains the Ant build script - build.xml. Before you can run any command, set the environment variable GWT_HOME to the top-level directory where GWT is installed. If you are in an Eclipse environment, you will need to restart the IDE for it to pick up the variable.

To build the source code and create the packages run the ant command as shown below:

$ cd $CAFESIP_HOME/gwt-components
$ ant
[the ant executable must be in your PATH and must have the JAVA_HOME environment variable set properly]

The source code is built and the output jar and zip files are created under the root directory.

There are other Ant targets as well. For a listing of the targets and their description, run the command - ant -p .

Top

Search this website 


Send questions or comments about this web site to webmaster@cafesip.org.
Copyright © 2005, CafeSip.org.
Licensed under the CafeSip License.
The CafeSip.org projects, web site and web facilities have been sponsored by QUIK Computing

Top of page