Setting up Java, GAE/J & GWT

• Install Java (at least Java 6 is required because we @Override annotations for interface implementations. If you manually get rid of @Override annotations, Java 5 should work, too)
• Install Google Web Toolkit (GWT) (Choosel requires GWT 2.1 (GWT 2.2 does not work right now)) - please download GWT 2.1 from here
• Install Google App Engine SDK for Java (Version 1.4 or later is recommended)

Setting up Eclipse

We recommend using Eclipse for working on Choosel. The following setup is known to work:

• Eclipse IDE for Java Developers 3.6 (Helios)
• Make sure that the version of Eclipse works with the Java version (e.g. 64bit Eclipse with 64bit Java, or 32bit/32bit)
• Subversion Plugin for Eclipse (you can use Help-->Eclipse Marketplace to install it)
• Subversive
• Team Providers
• Change Setting in Eclipse Preferences: Window/Preferences-->Team/SVN-->SVN Connector-->SVN Connector = SVNKit 1.3.0
• Google Plugin for Eclipse

Checking out Choosel and the example workbench from the SVN repository

• General project checkout information
• Check out "org.thechiselgroup.choosel.core" as Eclipse project
• Check out "org.thechiselgroup.choosel.dnd" as Eclipse project
• Check out "org.thechiselgroup.choosel.protovis" as Eclipse project
• Check out "org.thechiselgroup.choosel.visualization_component.chart" as Eclipse project
• Check out "org.thechiselgroup.choosel.visualization_component.graph" as Eclipse project
• Check out "org.thechiselgroup.choosel.visualization_component.map" as Eclipse project
• Check out "org.thechiselgroup.choosel.visualization_component.text" as Eclipse project
• Check out "org.thechiselgroup.choosel.visualization_component.timeline" as Eclipse project
• Check out "org.thechiselgroup.choosel.workbench" as Eclipse project
• Check out "org.thechiselgroup.choosel.example.workbench" as Eclipse project

Run Choosel

You should be able to run "choosel.example.workbench" in your development development environment now - just run the "choosel.example.workbench" launch configuration.

If you encounter problems setting up choosel with this guide, complain on the choosel mailing list :-)

IMPORTANT: Please be aware that Choosel is under active development and has not been released yet. Your code might break when updating Choosel due to changes that we make, and it is thus important to follow the commits that we make. If you're code break during a Choosel update and you can't figure out why, complain on the choosel mailing list :-)

More information and news on Choosel can be found at lgrammel.blogspot.com.

Optional setup

• To stay on top of code commits to Choosel, please consider installing the Eclipse RSS Plugin and configure it with the subversion commit feed for Choosel. You might also want to add the feed for issue tracker updates.
• If you work on choosel issue tracker items, you might want to consider using the Mylin-Google Code bridge to get issue tracker entries into Eclipse/Mylin. You can follow instructions 2 to 6 on Alex Ruiz's Weblog to set up issue tracking with Google Code.
• If you use Eclipse 3.6 abbreviated package names (Preferences-->Java/Appearance), the following abbreviations might be useful for you:

org.thechiselgroup.choosel=[choosel]