ICEfaces™ v2.0.2 Tool Bundle For Eclipse v3.

6 (Helios)

Overview
This ICEfaces Eclipse Integration provides ICEfaces 2 support for developers who use Eclipse IDE for Java EE
Developers (Helios, v3.6) for ICEfaces 2 application development. Note that only ICEfaces 2 is supported in this
release. ICEfaces 2.0.2 is the version to run with JavaServer Faces 2.0 on JavaEE 6 and 5 application server and is not
supposed to run with JavaServer Faces 1.2 or 1.1. This integration extends Eclipse's Web Tools Platform (WTP) and
provides following extra features for ICEfaces support.

• Adds ICEfaces Core, ICEfaces Component, Advanced Component, and ICEpush libraries to JSF projects
• Configures project for ICEfaces support
• Creates sample ICEfaces sample page
• Enabled ICEfaces Components on Eclipse Visual JSF Page Designer
• Provided visual editing capabilities of ICEfaces 2 Facelet xhtml; Drag & drop components onto page, edit
properties via properties editor, etc.

Note:
1. It is required to uninstall ICEfaces-2.0.0 eclipse integration bundle for eclipse 3.6 if it was installed prior to
installing this tool bundle due to the fact that these two bundles use the same design-time support plugin
module.
2. Required ICEfaces 2.0.2 libraraies (for most servers) are included in this bundle. Thus you don't need to
download these libraries from JSF wizard page as you might do in previous release.
3. Mojarra 2.1.1 RI library definition is provided by this integration and ICEsoft host majarra 2.1.1 bundle
temporarily in icefaces.org as it is the version we recommended. You should download the one marked as
"Download Provider - ICEsoft Technologies

Requirements
1. Eclipse IDE for Java EE Developers v3.6 (Helios)
This bundle includes required Eclipse WTP v3.2 (Web Tool Platform). It can be downloaded from
http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/galileor
2. ICEfaces-2.0.2–Eclipse-3.6-plugins.zip
This is core package of ICEfaces Eclipse Integration. It can be downloaded from
http://www.icefaces.org/main/downloads/os-downloads.iface.

Installation
Install ICEfaces Integration for Eclipse
Download ICEfaces-2.0.2–Eclipse-3.6-plugins.zip to a local directory,
To install ICEfacs Integration for Eclipse Helios
1. Start Eclipse. From Eclipse main menu bar, select Help -> Install New Software... -> Add --> Archive...
2. select ICEfaces-2.0.2–Eclipse-3.6-plugins.zip, and type in ICEfaces update or something into
Name: field. And click Ok.
3. Check the checkbox beside ICEfaces tools for Eclipse v3.6 (Helios)
4. Click Next to verify list of features from ICEfaces 2.0.2 eclipse tool bundle.
5. Click Next> and accepts Licences, finally click Finish. This step requires restart Eclipse.
Create new project with ICEfaces capabilities
The following instructions describe how to use how to create a new project with ICEfaces capabilities.
1. From Eclipse main menu bar, select File -> New -> Project...,
2. In New Project wizard, select Web -> Dynamic Web Project -> Next>
3. Type in project name, select Target Runtime, and/or Dynamic web module version. Select “ICEfaces 2
Default Project Configuration” for standard ICEfaces 2 project from Configuration drop down. Note option “
ICEfaces 2 Default Project Configuration” is not available if Dynamic web module version is below 2.5.
click Next>.
4. In JSF Capabilities wizard dialog, a download button available to download required JSF RI
library. Click the button. See below
5. Once download button is clicked, you will noticed list of JSF RI libraries available for you to download.
Download the one marked as "Download Provider - ICEsoft Technologies
6. After download, select optional libraries you want to include into your project by check the checkbox beside
each library. And also make sure to check the checkbox of Includes libraries with this application. Click
Next>.

7. ICEfaces wizard. Click Next>

Use ICEfaces components in Visual JSF Page Designer
New Eclipse Visual JSF Page Designer has been added since Eclipse 3.3 as part of WTP 2.0. It provides an intuitive
close-to-WYSIWIG editing experience. It allows visually JSF page layout and components drag and drop. See
JavaServer Faces Tooling Developer Guide for detail. This integration includes ICEfaces components
design time support for Eclipse Visual JSF Page Designer. ICEfaces components palette view, property view for
ICEfaces components' attributes are both supported.

1. Current Eclipse release doesn't set web page designer as default editor. Following the following instructions
to open ICEfaces page inweb page designer.
• Right click on the ICEfaces xhtml page
• Select Open with -> Other..., Select Web Page Editor, and click OK button
2. Select ICEfaces components in Palette view if you selected ICEfaces Compatibility mode.
3. Edit ICEfaces component attributes in Property editor