L0037 - 2010-11-27

Redistribution and other use of this material requires written permission from The RCP Company.

Basic Eclipse Configuration

Setup the Eclipse environment to get optimal performance for the course

L0037 - 2010-11-27

2

Eclipse Components and Versions

Java JDK 5 or 6 Eclipse SDK 3.5.1 Galileo Eclipse RCP SDK 3.5 (though not needed)

L0037 - 2010-11-27

3

Two Eclipse Installations

You need two Eclipse installations: Your development system Your target platform

For Eclipse development with other target architectures this is mandatory!

The primary advantage is that the IDE and product need not use the same version!

Also the exact target platform is under control and no extra plug-ins can sneak in…

Configure the target platform in the “Target Platform” preferences page

L0037 - 2010-11-27

4

Add to the Java Search

Add all plug-ins to the Java search This makes certain operations look at a much wider scope of plug-ins, which

means it is a lot easier to find classes and data In the “Plug-Ins” view of the PDE perspective

Select all plug-ins Use “Add to Java Search” in the context menu

L0037 - 2010-11-27

5

Eclipse Arguments

The Eclipse IDE should be launched using a windows shortcut with the following arguments

"C:\Program Files\eclipse\...\eclipse\eclipse.exe“ The application…

-clean All cache files are deleted

-data "D:\...\workspace“ The path of the workspace

-vm "C:\Program Files\Java\jre1.6.0_07\bin\javaw.exe“ The JWM to use in case there are multiple WMs installed

-vmargs Arguments for the VM (see next slide)

L0037 - 2010-11-27

6

Java VM Arguments

Specified after the –vmargs argument -Xmx<n>M

Max heap space (defaults to 512M in Ganymede and Galileo) -Xms<m>M

Initial heap space (defaults to 40M in Ganymede and Galileo) -XX:MaxPermSize=<m>M

Max memory for permanent data – like structures and classes My rules of thumb

<n> = Physical memory/2 <m>= <n>/4 But… your numbers depend on your machine and also on your resident

software like anti-virus and firewalls! Other arguments to consider:

-Duser.name="Tonny Madsen, The RCP Company“ Sets the name to use in javadoc comments for @author

-Declipse.cvs.anon=1 Includes the eclipse CVS repository automatically

L0037 - 2010-11-27

7

More Information

“Tuning Eclipse Performance and Avoiding OutOfMemoryExceptions” http://www.eclipsezone.com/eclipse/forums/t61618.html

“Running Eclipse” http://help.eclipse.org/ganymede/index.jsp?topic=/

org.eclipse.platform.doc.user/tasks/running_eclipse.htm The basic eclipse runtime arguments

“Eclipse Runtime Options” http://help.eclipse.org/ganymede/index.jsp?topic=/

org.eclipse.platform.doc.isv/reference/misc/runtime-options.html List of the usable system properties

“Manage your Eclipse environment” http://www-128.ibm.com/developerworks/opensource/library/os-ecl-

manage/