How to set up eclipse for EDNA developments

From EdnaWiki
Jump to: navigation, search

Before installing eclipse, make sure you have the following software installed:

  • Python version 2.4 or higher
  • Java version 1.6 or higher (eclipse should work with Java version 1.5 however we have experience problems using Java 1.5 and eclipse on Linux so to be on the safe side use Java 1.6).

Installing eclipse

Download eclipse from: http://www.eclipse.org/downloads

You can choose any distribution you want, however if you choose the "plugin development" one you will have automatically the XML/XSD editor plugin installed which are very handy.

You must then install the following plugins:

Setting up eclipse for EDNA

Select a workspace

When starting up eclipse you will be asked the location for the workspace. Either accept the default location or change the path to another directory. The edna project will be checked out in this workspace directory.

Set the proxy

If your computer is located behind a firewall, especially at ESRF (call the hotline: 24-24), you will have to get the proxy settings from your local network administrator: proxy address and port. Then the first thing to set after having started eclipse is the proxy settings:

  1. Open the eclipse preferences : "Window" -> "Preferences"
  2. In the Preferences window, open the "General" item
  3. Click on "Network Connection"
  4. Select "Manual proxy configuration" and enter the proxy name and port (e.g. proxy.site.com, 3128).

Furthermore, subclipse does not use these settings so on Windows, edit \Documents and Settings\username\Application Data\Subversion\servers and add in under the [global] section

http-proxy-exceptions = *.site.com

http-proxy-host = proxy.site.com

http-proxy-port = 3128

On Unix, the file resides in $HOME/.subversion.

Set up the Python interpreter for Pydev

  1. Open the eclipse preferences : "Window" -> "Preferences"
  2. In the "Preferences" window, open the "Pydev" item
  3. Click on "Interpreter - Python"
  4. Click on the "New" button next to the "Python interpreters" text field
  5. Select the python executable for the Python installation you would like to use (for example /usr/bin/python2.5)
  6. Accept the selection proposed in the "Selection Needed" window by clicking on "OK"
  7. Close the "Preferences" window by clicking on "OK"

Check out the EDNA subversion repository trunk

  1. If the "SVN Repository Exploring Perspective" isn't visible open it : "Window" -> "Open Perspective" -> "Other", in the "Open Perspective" window choose "SVN Repository Exploring" and click on "OK"
  2. In the "SVN Repositories" tab on the left side, right-click and choose "New" -> "Repository Location..."
  3. In the "New Repository Location" window type "http://www.edna-site.org/svn" in the URL field, and fill in your user name and password in the "Authentication" filed. Do not change any other fields / tabs.
  4. In the "SVN Repositories" tab you will see a new icon with the text "http://www.edna-site.org/svn". Click on the trangle next to the icon, then click on the trangle next to "trunk", then right-click on "edna" and choose "Check out". (If you would like to check out the enda trunk as a different name, for example "edna-HEAD", choose "Find/Check out as..." instead of "Check out".

Set up the edna Pydev project

  1. Open the "Pydev" perspective (as above, if it is not visible open it with "Window" -> "Open Perspective" -> "Other", in the "Open Perspective" window choose "Pydev" and click on "OK")
  2. In the "Pydev Package Explorer" (on the left), right-click on the edna package and choose "Pydev" -> "Set as Pydev project"