Difference between revisions of "Eclipse"

From ArchWiki
Jump to: navigation, search
(Plugins)
m (Adding link to PTP plugin. It seems interesting to me to know that there is a plugin for parallel programming)
(13 intermediate revisions by 8 users not shown)
Line 11: Line 11:
 
[[Pacman|Install]] the {{Pkg|eclipse}} package from the [[official repositories]].
 
[[Pacman|Install]] the {{Pkg|eclipse}} package from the [[official repositories]].
 
This base package has [[Java]] development support built in.
 
This base package has [[Java]] development support built in.
 +
 +
=== Eclipse for Java ===
 +
 +
The Eclipse IDE for Java Developers can be installed with the {{AUR|eclipse-java}} package from AUR.
  
 
== Plugins ==
 
== Plugins ==
Line 18: Line 22:
 
=== Add the default update site ===
 
=== Add the default update site ===
  
Make sure that you first add the default update site for your installed version of Eclipse so that plugin dependencies can automatically be installed. The most current version of Eclipse is Juno and the default update site for Juno is: http://download.eclipse.org/releases/juno. Go to Help > Install new Software > Add, fill the name to easily identify the update site later - for instance, Juno Software Repository - and fill the location with the url.
+
Make sure that you check that the default update site for your version of Eclipse is configured so that plugin dependencies can automatically be installed. The most current version of Eclipse is Kepler and the default update site for Kepler is: http://download.eclipse.org/releases/kepler. Go to Help > Install new Software > Add, fill the name to easily identify the update site later - for instance, Kepler Software Repository - and fill the location with the url.
  
 
=== Eclipse Marketplace ===
 
=== Eclipse Marketplace ===
  
{{Note|
+
{{Note|make sure you've followed the [[#Add the default update site|Add the default update site]] section.}}
* make sure you've followed the [[#Add the default update site|Add the default update site]] section.
+
To use the Eclipse Marketplace, first you need to install it (hey, that feels familiar. I wonder why?). Go to Help > Install new software > switch to the default update site > General Purpose Tools > Marketplace Client. Restart Eclipse and it will be available in Help > Eclipse Marketplace.
}}
+
To use the Eclipse Marketplace, first you need to install it (hey, that fells familiar. I wonder why?). Go to Help > Install new software > switch to the default update site > General Purpose Tools > Marketplace Client. Restart Eclipse and it will be available in Help > Eclipse Marketplace.
+
  
 
=== Plugin manager ===
 
=== Plugin manager ===
  
{{Note|
+
{{Note|make sure you've followed the [[#Add the default update site|Add the default update site]] section.}}
* make sure you've followed the [[#Add the default update site|Add the default update site]] section.
+
}}
+
 
Use Eclipse's plugin manager to download and install plugins from their original repositories: in this case you have to find the needed repository in the plugin's website, then go to ''Help > Install New Software...'', enter the repository in the ''Work with'' field, select the plugin to install from the list below and follow the instructions.
 
Use Eclipse's plugin manager to download and install plugins from their original repositories: in this case you have to find the needed repository in the plugin's website, then go to ''Help > Install New Software...'', enter the repository in the ''Work with'' field, select the plugin to install from the list below and follow the instructions.
  
Line 51: Line 51:
 
=== List of plugins ===
 
=== List of plugins ===
  
* {{App|Aptana|HTML5/CSS3/JavaScript/Ruby/Rails/PHP/Pydev/Django support. Also available as standalone application|http://www.aptana.com/|{{AUR|eclipse-aptana}} {{AUR|aptana-studio}}}}
+
* {{App|AVR|AVR microcontroller plugin.|http://avr-eclipse.sourceforge.net/wiki/index.php/The_AVR_Eclipse_Plugin|{{AUR|eclipse-avr}}}}
 +
* {{App|Aptana|HTML5/CSS3/JavaScript/Ruby/Rails/PHP/Pydev/Django support. Also available as standalone application.|http://www.aptana.com/|{{AUR|eclipse-aptana}} {{AUR|aptana-studio}}}}
 
* {{App|Eclipse CDT|C/C++ support.|http://www.eclipse.org/cdt/|{{Pkg|eclipse-cdt}}}}
 
* {{App|Eclipse CDT|C/C++ support.|http://www.eclipse.org/cdt/|{{Pkg|eclipse-cdt}}}}
 
* {{App|Eclipse PDT|[[PHP]] support.|http://www.eclipse.org/pdt/|{{AUR|eclipse-pdt}}}}
 
* {{App|Eclipse PDT|[[PHP]] support.|http://www.eclipse.org/pdt/|{{AUR|eclipse-pdt}}}}
 
* {{App|EGit|[[Git]] support.|http://www.eclipse.org/egit|{{AUR|eclipse-egit}}}}
 
* {{App|EGit|[[Git]] support.|http://www.eclipse.org/egit|{{AUR|eclipse-egit}}}}
 
* {{App|EPIC|Perl support.|http://www.epic-ide.org/|{{AUR|eclipse-epic}}}}
 
* {{App|EPIC|Perl support.|http://www.epic-ide.org/|{{AUR|eclipse-epic}}}}
* {{App|MercurialEclipse|[[Mercurial]] support.|http://code.google.com/a/eclipselabs.org/p/mercurialeclipse/|{{AUR|eclipse-mercurial}}}}
+
* {{App|IvyDE|IvyDE dependency Manager.|https://ant.apache.org/ivy/ivyde/|{{AUR|eclipse-ivyde}}}}
 +
* {{App|Markdown|Markdown editor plugin for Eclipse.|https://ant.apache.org/ivy/ivyde/|{{AUR|eclipse-markdown}}}}
 +
* {{App|MercurialEclipse|[[Mercurial]] support.|http://www.winterwell.com/software/markdown-editor.php|{{AUR|eclipse-mercurial}}}}
 
* {{App|Mylyn|Task lists support.|http://www.eclipse.org/mylyn/|{{AUR|eclipse-mylyn}}}}
 
* {{App|Mylyn|Task lists support.|http://www.eclipse.org/mylyn/|{{AUR|eclipse-mylyn}}}}
 
* {{App|PHPEclipse|Alternative PHP support.|http://www.phpeclipse.com/|{{AUR|eclipse-phpeclipse}}}}
 
* {{App|PHPEclipse|Alternative PHP support.|http://www.phpeclipse.com/|{{AUR|eclipse-phpeclipse}}}}
Line 62: Line 65:
 
* {{App|Subclipse|[[Subversion]] support.|http://subclipse.tigris.org/|{{AUR|eclipse-subclipse}}}}
 
* {{App|Subclipse|[[Subversion]] support.|http://subclipse.tigris.org/|{{AUR|eclipse-subclipse}}}}
 
* {{App|Subversive|Alternative Subversion support.|http://www.eclipse.org/subversive/|{{AUR|eclipse-subversive}}}}
 
* {{App|Subversive|Alternative Subversion support.|http://www.eclipse.org/subversive/|{{AUR|eclipse-subversive}}}}
 +
* {{App|TestNG|TestNG support.|http://testng.org/doc/eclipse.html|{{AUR|eclipse-testng}}}}
 
* {{App|TeXlipse|[[LaTeX]] support.|http://texlipse.sourceforge.net/|{{AUR|texlipse}}}}
 
* {{App|TeXlipse|[[LaTeX]] support.|http://texlipse.sourceforge.net/|{{AUR|texlipse}}}}
 +
* {{App|Eclipse PTP|Parallel Programming C/C++ support.|http://www.eclipse.org/ptp/|{{AUR|eclipse-ptp}}}}
  
 
== Enable javadoc integration ==
 
== Enable javadoc integration ==
Line 79: Line 84:
 
=== Offline version ===
 
=== Offline version ===
  
If you have no internet connection on your development machine or do not want to constantly consume bandwidth for the documentation, you can store the documentation locally, by installing the {{Pkg|openjdk7-src}} package. Eclipse should find the javadocs automatically.
+
You can store the documentation locally by installing the {{Pkg|openjdk7-doc}} package. Eclipse may be able to find the javadocs automatically.  If that doesn't work, set Javadoc location for rt.jar to {{ic|file:/usr/share/doc/openjdk7-doc/api}}.
  
 
== Troubleshooting ==
 
== Troubleshooting ==
Line 111: Line 116:
 
=== Ctrl+X closes Eclipse ===
 
=== Ctrl+X closes Eclipse ===
  
Part of [https://bugs.eclipse.org/bugs/show_bug.cgi?id=318177 this] bug. Just look in {{ic|~/workspace/.metadata/.plugins/org.eclipse.e4.workbench/workbench.xmi}} and delete the wrong {{Keypress|Ctrl+X}} combination. Usually it is the first one.
+
Part of [https://bugs.eclipse.org/bugs/show_bug.cgi?id=318177 this] bug. Just look in {{ic|~/workspace/.metadata/.plugins/org.eclipse.e4.workbench/workbench.xmi}} and delete the wrong {{ic|Ctrl+X}} combination. Usually it is the first one.
  
 
=== Eclipse 4.2.0 not respecting dark/custom gtk themes resulting in white background ===
 
=== Eclipse 4.2.0 not respecting dark/custom gtk themes resulting in white background ===
Line 119: Line 124:
  
 
Solution source: http://www.eclipse.org/forums/index.php/m/872214/
 
Solution source: http://www.eclipse.org/forums/index.php/m/872214/
 +
 +
This also works with version 4.3.x (Kepler) by backing up the css folder from /usr/share/eclipse/plugins/org.eclipse.platform_4.3.xxx/css/
  
 
=== Tooltips have dark background color with Gnome 3.6 Adwaita theme ===
 
=== Tooltips have dark background color with Gnome 3.6 Adwaita theme ===

Revision as of 19:41, 1 October 2013

Eclipse is an open source community project, which aims to provide a universal development platform. The Eclipse project is most widely known for its cross-platform integrated development environment (IDE). The Arch Linux packages (and this guide) relate specifically to the IDE.

The Eclipse IDE is largely written in Java but can be used to develop applications in a number of languages, including Java, C/C++, PHP, Perl and Python. The IDE can also provide subversion support and task management.

Installation

Install the eclipse package from the official repositories. This base package has Java development support built in.

Eclipse for Java

The Eclipse IDE for Java Developers can be installed with the eclipse-javaAUR package from AUR.

Plugins

Many plugins are easily installed using pacman (see Eclipse plugin package guidelines for further informations). This will also keep them up-to-date. Alternatively, you can choose either the Eclipse Marketplace or the internal plugin manager.

Add the default update site

Make sure that you check that the default update site for your version of Eclipse is configured so that plugin dependencies can automatically be installed. The most current version of Eclipse is Kepler and the default update site for Kepler is: http://download.eclipse.org/releases/kepler. Go to Help > Install new Software > Add, fill the name to easily identify the update site later - for instance, Kepler Software Repository - and fill the location with the url.

Eclipse Marketplace

Note: make sure you've followed the Add the default update site section.

To use the Eclipse Marketplace, first you need to install it (hey, that feels familiar. I wonder why?). Go to Help > Install new software > switch to the default update site > General Purpose Tools > Marketplace Client. Restart Eclipse and it will be available in Help > Eclipse Marketplace.

Plugin manager

Note: make sure you've followed the Add the default update site section.

Use Eclipse's plugin manager to download and install plugins from their original repositories: in this case you have to find the needed repository in the plugin's website, then go to Help > Install New Software..., enter the repository in the Work with field, select the plugin to install from the list below and follow the instructions.

Note:
  • If you install plugins with Eclipse's plugin manager, you are advised to launch Eclipse as root: this way the plugins will be installed in /usr/share/eclipse/plugins/; if you installed them as normal user, they would be stored in a version-dependent folder inside ~/.eclipse/, and, after upgrading Eclipse, they wouldn't be recognized any longer.
  • Do not use Eclipse as root for your everyday work.

Updates via plugin manager

Run Eclipse and select Help > Check for Updates. If you have installed them as root as advised in the section above, you have to run Eclipse as root.

For plugins to be updated, you should check to have their update repositories enabled in Window > Preferences > Install/Update > Available Software Sites: you can find each plugin's repository(es) on the respective project website. To add, edit, remove... repositories just use the buttons on the right of the Available Software Sites panel. For Eclipse 4.2 (Juno), check you have enabled this repository:

http://download.eclipse.org/releases/juno

To receive update notifications, go to Window > Preferences > Install/Update > Automatic Updates. If you want to receive notifications for plugins installed as root, you should run Eclipse as root, go to Window > Preferences > Install/Update > Available Software Sites, select the repositories related to the installed plugins and Export them, then run Eclipse as normal user and Import them in the same panel.

List of plugins

  • AVR — AVR microcontroller plugin.
http://avr-eclipse.sourceforge.net/wiki/index.php/The_AVR_Eclipse_Plugin || eclipse-avrAUR
  • Aptana — HTML5/CSS3/JavaScript/Ruby/Rails/PHP/Pydev/Django support. Also available as standalone application.
http://www.aptana.com/ || eclipse-aptanaAUR aptana-studioAUR
  • Eclipse CDT — C/C++ support.
http://www.eclipse.org/cdt/ || eclipse-cdt
  • Eclipse PDTPHP support.
http://www.eclipse.org/pdt/ || eclipse-pdtAUR
  • EGitGit support.
http://www.eclipse.org/egit || eclipse-egitAUR
  • EPIC — Perl support.
http://www.epic-ide.org/ || eclipse-epicAUR
  • IvyDE — IvyDE dependency Manager.
https://ant.apache.org/ivy/ivyde/ || eclipse-ivydeAUR
  • Markdown — Markdown editor plugin for Eclipse.
https://ant.apache.org/ivy/ivyde/ || eclipse-markdownAUR
http://www.winterwell.com/software/markdown-editor.php || eclipse-mercurialAUR
  • Mylyn — Task lists support.
http://www.eclipse.org/mylyn/ || eclipse-mylynAUR
  • PHPEclipse — Alternative PHP support.
http://www.phpeclipse.com/ || eclipse-phpeclipseAUR
http://pydev.org/ || eclipse-pydevAUR
http://subclipse.tigris.org/ || eclipse-subclipseAUR
  • Subversive — Alternative Subversion support.
http://www.eclipse.org/subversive/ || eclipse-subversiveAUR
  • TestNG — TestNG support.
http://testng.org/doc/eclipse.html || eclipse-testngAUR
  • TeXlipseLaTeX support.
http://texlipse.sourceforge.net/ || texlipseAUR
  • Eclipse PTP — Parallel Programming C/C++ support.
http://www.eclipse.org/ptp/ || eclipse-ptpAUR

Enable javadoc integration

Want to see API entries when hovering the mouse pointer over standard Java methods?

Online version

If you have constant Internet access on your machine, you can use the on-line documentation:

  1. Go to Window > Preferences, then go to Java > Installed JREs.
  2. There should be one named "java" with the type "Standard VM". Select this and click Edit.
  3. Select the /opt/java/jre/lib/rt.jar item under "JRE system libraries:", then click Javadoc Location....
  4. Enter "http://docs.oracle.com/javase/7/docs/api/" in the "Javadoc location path:" text field.

Offline version

You can store the documentation locally by installing the openjdk7-doc package. Eclipse may be able to find the javadocs automatically. If that doesn't work, set Javadoc location for rt.jar to file:/usr/share/doc/openjdk7-doc/api.

Troubleshooting

Autocompletion and javadoc render crash

For some reason, libxul may crash Eclipse with a traceback like:

# Problematic frame:
# C  [libxul.so+0xd07552]  NS_InvokeByIndex_P+0x5e9a

To fix this issue, you can try installing libwebkit and adding the following lines in your /usr/share/eclipse/eclipse.ini:

-Dorg.eclipse.swt.browser.UseWebKitGTK=true

If that does not work (or if you do not want to use libwebkit) download:

http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/1.9.0.17/runtimes/xulrunner-1.9.0.17.en-US.linux-i686.tar.bz2

Unpack it into ~/.local/xulrunner (or another location) and add this line to your Eclipse configuration file /usr/share/eclipse/eclipse.ini:

-Dorg.eclipse.swt.browser.XULRunnerPath=/home/<Username>/.local/xulrunner

Now everything should just work fine and tooltips should display correctly. To prevent overwriting this configuration on update, append /usr/share/eclipse/eclipse.ini to the NoUpgrade line in /etc/pacman.conf as follows:

/etc/pacman.conf
NoUpgrade = usr/share/eclipse/eclipse.ini

Crash on first boot or when choosing Help > Welcome

See #Autocompletion and javadoc render crash.

Ctrl+X closes Eclipse

Part of this bug. Just look in ~/workspace/.metadata/.plugins/org.eclipse.e4.workbench/workbench.xmi and delete the wrong Ctrl+X combination. Usually it is the first one.

Eclipse 4.2.0 not respecting dark/custom gtk themes resulting in white background

Remove or move to backup sub folder all of the .css files from: /usr/share/eclipse/plugins/org.eclipse.platform_4.2.0.v201206081400/css/

Solution source: http://www.eclipse.org/forums/index.php/m/872214/

This also works with version 4.3.x (Kepler) by backing up the css folder from /usr/share/eclipse/plugins/org.eclipse.platform_4.3.xxx/css/

Tooltips have dark background color with Gnome 3.6 Adwaita theme

Comment out the second-to-last line in /usr/share/themes/Adwaita/gtk-2.0/gtkrc like this

#widget "gtk-tooltip*"  style "tooltips"

Related bugs:

Toggle buttons states are the same for selected/not selected

Comment out the last line in /usr/share/themes/Adwaita/gtk-2.0/gtkrc like this

#widget "*swt*toolbar*" style "null"

To apply the fixed theme, use gnome-tweak-tool to select a different theme and cycle back to Adwaita.

Related bugs:

See also