Setting up Eclipse and plug-ins

Getting Eclipse
---------------

Eclipse can be installed via

* Distribution package manager on Linux

* `EasyEclipse bundle <http://easyeclipse.org/>`_

* Standalone install from `eclipse.org <http://eclipse.org>`_

**On Linux**

On Linux distrubtion, I suggest you to use Eclipse coming with your distribution or there might be problems with the embedded Mozilla browser. If you choose not to use EasyEclipse installer, you need to instal `PyDev <http://pydev.sourceforge.net>`_ and `Subclipse <subclipse.tigris.org>`_ manually.

On Ubuntu, you `need to increase Eclipse launcher Java heap size or Eclipse will randomly crash <https://bugs.launchpad.net/ubuntu/+source/eclipse/+bug/83779>`_.

64-bit Linux has problems with Eclipse and you might want to `install Eclipse in 32-bit mode <http://www.64bitjungle.com/tech/eclipse-32-bit-pdt-install-on-64-bit-ubuntu/>`_.

**On Windows**

* Download `EasyEclipse for Python <http://easyeclipse.org/site/distributions/python.html>`_ on Windows.

* Ensure that you have at least Java SE 1.5.x installed installed and the JAVA_HOME set.

* Download java from `Sun's Java site <http://java.sun.com>`_.

Launching Eclipse
-----------------

- On Linux, go to the folder in terminal and type *./eclipse* or use start menu shortcut if you are using Eclipse from your Linux distribution

- On Windows, double click eclipse.exe

Installing plug-ins
-------------------

The easiest way to install Eclipse plug-ins is via menu *Help -> Software Updates -> Find and Install -> Search for new features to install*. You can copy-paste Eclipse update site URLs and Eclipse automatically downloads and install wanted plug-ins from them.

Pydev
-----

* EasyEclipse bundle contains this

* Eclipse update site URL: http://pydev.sourceforge.net/updates/

* If you want to use commercial PyDev extension (strongly recommended, increases productivity), add Eclipse update site
http://www.fabioz.com/pydev/updates

* After installing the plug-in you need to configure the Python interpreters. Go to Window -> Preferences -> PyDev. Under *Interpreter -
Python*, click New and find your installed Python interpreter. On Windows this is::

C:\Python24\Python.exe

On Linux this is::

/usr/bin/python2.4

Subclipse
---------

* EasyEclipse bundle contains this

* Eclipse update site URL: http://subclipse.tigris.org/update_1.4.x/

Aptana - Web 2.0 developer plug-ins
------------------------------------

`Aptana <http://www.aptana.com/studio>`_ is a suite of web 2.0 development plug-ins for Eclipse. It comes with state of the art HTML, CSS and Javascript editors. You can even do in-browser Javascript step-by-step debugging using Aptana Debugging Extension and Eclipse.

* Follow instructions at `the download page <http://www.aptana.com/studio/download>`_ how to install Aptana as Eclipse plug-in (not standalone download)

* For Linux/AMD64 architecture see `this page <http://forums.aptana.com/viewtopic.php?t=134&postdays=0&postorder=asc&start=30>`_ for solving some issues

gettext and i18n
-----------------

When creating new products, text labels and such are inputted in gettext .po format files. Eclipse has `gted <http://www.gted.org/#Installation>`_ plug-in to for advanced editing of i18n files.

Saving the dinosaur
--------------------

If you are a seasoned Unix developer, you might find the following ease your pain when migrating to Eclipse:

* `viPlugin <http://www.satokar.com/viplugin/>`_

* `Emacs Environment for Eclipse <http://park.ruru.ne.jp/ando/work/who/ee2e/>`_

Java 1.6.10 bug
---------------
You might need to tweak your Eclipse launch settings with Sun Java 1.6.10 if Eclipse exits randomly:
https://bugs.eclipse.org/bugs/show_bug.cgi?id=214092