ICEfaces 3.0.x and Maven

If you are a Maven user, there are a couple of different ways for getting the ICEfaces 3.0.x libraries for use in your project. You can use the libraries provided from the ICEfaces Maven Repository or you can compile and build the source code locally and install those libraries into your local Maven repository.

From the ICEfaces Maven Repository

The Maven poms and jars for this distribution are located in the following ICEfaces Maven repository. Just add this repository entry to your own .pom files:

     <repository>
        <id>snapshots</id>
        <url>http://anonsvn.icefaces.org/repo/maven2/releases/</url>
     </repository>

Then you can add the dependencies for the libraries you wish to use. For example to add the ACE components and the transitive dependency on ICEfaces:

    <dependency>
        <groupId>org.icefaces</groupId>
        <artifactId>icefaces-ace</artifactId>
        <version>3.0.1</version>
    </dependency>

Building and Installing to Local Maven Repository

In ICEfaces 3.0.x, there is no support for building the ICEfaces libraries themselves using Maven. ICEfaces source code can only be compiled and packaged into .jar files by Ant. If you have downloaded the Source distribution bundle of ICEfaces, you will need to:

Compile and build the ICEfaces libraries.
Install them into your local Maven repository.

Compile and Build with Ant

The ICEfaces Binary distribution bundle comes with prebuilt ICEfaces libraries so the steps in this section are not necessary.

To build the ICEfaces libraries, open a console or shell and navigate to the "icefaces" directory where you unzipped the ICEfaces distribution. Then, in the console, type the following and press Enter:

> ant allclean world

This builds all of the ICEfaces libraries and sample applications suitable for deployment to any JEE 6 Web Profile platform, such as Glassfish 3.

Install to Local Maven Repository

The [icefaces.install.dir]/icefaces/maven2 folder contains an Ant build script for doing the required Maven tasks. To use this script:

Modify the contents of the file [icefaces.install.dir]/icefaces/maven2/build.properties so that the local.repository property is set to the path of your local Maven repository. For example:

local.repository=/Users/myName/.m2/repository/

To install the ICEfaces .jar files into your local Maven repository, open a shell or console window and navigate to [icefaces.install.dir]/icefaces/maven2.

Download the the maven library that allows Ant to perform the required Maven tasks (this should only need to be done once). Type the following and hit Enter:

> ant get-maven

To install the ICEfaces libraries into your local Maven repository, type the following and hit Enter:

> ant install

The locally built ICEfaces .jar files should now be installed in the local Maven repository of your machine and you can now add them as dependencies in your .pom files as outlined in the first section of this page.

ICEfaces 3.0.x and Maven