HOWTO Use Eclipse With Celeste

Getting Started with Celeste and Eclipse

1. Get a copy of Java SE 1.6 http://java.sun.com See the instructions in HOWTO Build Celeste. Mac OSX users: pay particular attention to setting up Java on Mac OSX.
2. Get a copy of the Celeste sources. See the guides on how to check out from the repository or get a tarball.
3. Download Eclipse
   From the http://www.eclipse.org website, download the latest version of "Eclipse IDE For Java Developers" for your system.
4. Start Eclipse
   Do whatever is necessary on your computer to install and start the eclipse platform. If this is the first time you've run Eclipse, it will prompt you to create an Eclipse workspace. The Eclipse workspace is NOT the Celeste source directory---Eclipse can have muliple projects within a Workspace, each with their own directory hierarchies of sources.
5. Incorporate Celeste
   1. Select from the main Workbench menu: File ->New ->Project...
   2. A dialog box is displayed
   3. Open up the Java item and select Java Project from existing Ant Buildfile.
   4. Type in the Project name: field the name of your project (Eg. "Celeste"), select the Ant buildfile: which is the file build.xml in the top-level directory of your sources, then select javac task found in target "compile"
      Leave the Link to the buildfile... unchecked.
   5. Click Finish (If the main Eclipse window shows again, select "Workbench")

NOTE: If you get build errors in Eclipse, check the build environment for the project by:

1. Choosing Project->Properties to display the Properties dialog window.
2. Click on the Java Build Path
   1. Select Libraries pane.
   2. You may see an error message about deprecated libraries.
   3. Click the Add Library... button and select the JRE System Library, click the Next button.
   4. In the Add Library dialog window, select *Alternate JRE" then "Installed JRE's" displaying the 'Installed JREs' dialog window.
   5. Choose the "1.6 JRE" and click OK
3. Now you're back at the Libraries pane. Remove the old JRE that was there previously, leaving the one you just added.
4. Click the OK button.
5. Then choose Project->Clean... from the drop down menu.