We need to ask you to install a new copy of Eclipse. Even if you are already an existing Eclipse user - please follow the directions of this page as we need to be very specific with respect to version.

Install Eclipse for RCP / Plug-in Developers

Windows Developers

1. Please start by downloading the latest eclipse: http://www.eclipse.org/downloads/packages/
   • Choose the correct Eclipse for RCP/Plug-in Developers link for your platform (example "win32").
   • We always try and make use of the latest stable Eclipse for RCP/Plug-in Developers
     • uDig 1.2.x: Eclipse 3.4.x Downloads Ganymede
   • Previous versions of uDig will need to be developed on the "matching" version of the Eclipse RCP platform:
     • uDig 1.1.x: Eclipse 3.3.2 Downloads Europa
     • uDig 1.0.x: Eclipse 3.1.1 Downloads
2. Now download a set of "extra" plug-ins that have been prepared by the uDig team.
   • Select the pre-packaged extras for your version of eclipse from: http://udig.refractions.net/downloads/extras
     • http://udig.refractions.net/files/downloads/extras/extras-3.4.0.zip
3. Unzip your eclipse download to a convenient directory:
   C:\java
   This will create an eclipse directory.

    eclipse/
      configuration/
      dropins/
      features/
      p2/
      plugins/
      eclipse.exe
      eclipse.ini
      ...
   

4. Unzip the extras download into your new eclipse/dropins directory:
   This will create the following directory structure:

    eclipse/
      configuration/
      dropins/
        extas-3.4.0/
          eclipse/
            features/
            plugins/
      features/
      p2/
      plugins/
      eclipse.exe
      eclipse.ini
      ...
   

   This extras download included the ResourceBundle editor and other required plugins)

5. Navigate to your eclipse directory and right-click on the eclipse.exe file and select Send To->Desktop.
   
6. Right-click on the new link, and select Properties.
7. After the Target name, add the flags:
   -vmargs -Xmx512m
   
8. You can use this short cut to run eclipse; after we have added a few more plug-ins into the mix

You may safely skip the rest of this page; it covers the manual installation of the plug-ins included as part of the "extras download".

The extras pack includes a recent version of: Resource Bundle Editor, Maven Ant Tasks, RCP Delta Pack, Testing Framework, uDig Developers Guide, and RCP-base language packs (German, Spanish, French, Italian, Japanese, Korean, Portuguese (Brazil), Traditional Chinese and Simplified Chinese). If you are interested in the details please see the "manual install" portion of this page.

OS X Install Instructions

1. For Eclipse 3.3.1 (only) you will need to apply the MaxPermSize hack.
   Please modifying the eclipse.ini file located in the Eclipse.app:
   Eclipse.app/Contents/MacOS/eclipse.ini
   • The file looks like this after the modification:

     -showsplash org.eclipse.platform
     -vmargs
     -XX:MaxPermSize=256m
     -XX:PermSize=64M
     -Xdock:icon=../Resources/Eclipse.icns
     -XstartOnFirstThread
     -Dosgi.requiredJavaVersion=1.5
     -Xms40m
     -Xmx512m
     

Linux Install Instructions

1. Follow the windows instructions (downloading the eclipse for linux of course)
2. Be careful when unzipping the eclipse and extras zips - they both contain plugin and features folders that need to be combined.
3. Ensure JAVA_HOME is set (see 04 Java Runtime Environment for details)

Tips:

• You can download a linux specific JRE from our website (and create a jre folder inside your eclipse directory)
• You could run eclipse using your operating systems Java; just be sure to use the jre above as your JRE target

Manual Install

The material in this section is included in extras download - you may skip this section! The exact content included in "extras" is marked with a in following section.

Required Downloads included in Extras

	Project	Example Download
	RCP SDK	eclipse-3.4-delta-pack.zip	required
	maven-ant-tasks	mavn-ant-tasks.zip	required

We need to install an additional downloads into your eclipse directory for cross platform development:

1. The delta pack download is available from the "Latest Release" link on the following page:
   http://download.eclipse.org/eclipse/downloads/
2. The "delta pack" is listed on this page under the "RCP SDK" heading
3. You can download maven-ant-tasks from http://udig.refractions.net/files/downloads/extras/
4. Download and unzip into your eclipse directory

   If you need to update maven-ant-tasks you can find the source code here: http://svn.refractions.net/udig/udig/trunk/extras/org.apache.maven-ant-tasks/

Optional Downloads

	Eclipse Plug-in		Download
	Eclipse Resource Bundle Editor	optional	http://sourceforge.net/projects/eclipse-rbe/
	uDig Developers Guide	recommended	http://udig.refractions.net/confluence/display/DEV/Home
	GeoTools User Guide	recommended	http://docs.codehaus.org/display/GEOTDOC/Home

Installing plug-ins directly:

1. If you want to install the Eclipse Resource Bundle Editor you will need to download and unzip into your eclipse directory - there is no update site at this time.
2. You can pick up the net.refractions.udig.doc plug-in from your source code check out and drop it directly into your eclipse directory as well - it include useful documentation for use when developing.

   If you need to update net.refractions.udig.dev you can find the source code here: http://svn.refractions.net/udig/udig/trunk/extras/net.refractions.udig.dev/

Optional Language Pack Downloads

There are a couple of options for obtaining the language packs required for working on uDig internationalization.

Use Babel Project Update Site

There is now the option of using the babel project update site for eclipse translations.

Use Unofficial Language Pack

	Target Platform	Language Pack
	Platform Runtime SDK Language Packs	NLhack-eclipse-SDK-3.3.1.zip	optional

If the language packs have not yet been released for the version of eclipse you are using - then we are in trouble! Andrea Antonello has prepared a hack by downloading an old version; unzipping and hacking up all the version numbers:
http://udig.refractions.net/downloads/extras/
(Look for a file like NLhack-eclipse-SDK-3.3.1.zip)

Use Official Language Pack

The official language pack has not been released in a form compatible with Eclipse 3.3 yet. These instructions are still here in the hopes an official language pack will be made available in the future.

	Target Platform	Language Pack
	Platform Runtime Language Packs	NLpack1	required
		NLpack2	optional
		NLpack2a	optional
		NLpackBidi	optional
	Platform SDK Language Packs	NLpack1	optional

For international development we need to add several language packs to your eclipse directory:

1. Use the "Language Pack" link on the following page:
   http://download.eclipse.org/eclipse/downloads/
2. If the version of the language pack matches the Eclipse you are using you can proceed:
   1. Scroll down to Platform Runtime Language Packs and download the NLpack1
   2. Optional: You can download the NLpack2 or NLpackBidi if you want additional lanaguages.
   3. Optional: Add the SDK language pack to your IDE if you want eclipse to be internationalized

Previous: 02 Checkout Source Code Next: 04 Java Runtime Environment