ECLIPSE CODE

Maintainability of Eclipse Code



Maintainability of Eclipse code

Introduction

If you are running Eclipse 3.2 or later and Subclipse we have prepared a recommended setup configured through the Team Project Set Files For ArgoUML. These are Eclipse .psf files which can be used to automatically check out the project (DeNatale, 2008, pp. 12-14).

The directory structure of an Eclipse check-out of the main source code now mirrors the svn repository structure (since 20 April 2008). For details on the directory structure and layouts, see Source layout. The argouml-core-projectset.psf project set contains a small subset of the full repository. It only contains the files and directories needed to build argouml using Eclipse. It is possible to extend the core project set by importing the argouml-command-line-build.psf file into an existing workspace. This will add the necessary tools to build argouml from the command line; this build can then be run without opening Eclipse. Alternatively, you could achieve the same result by checking-out trunk/ on the command line, and using Eclipse to edit the files (not requiring any .psf files).

For the recommended setup to work we make certain assumption on what modules you have available in your Eclipse. The following are needed:

Subclipse

Ant

JUnit 3

PDE Tools

Eclipse installation instructions

These instructions are tested on Eclipse 3.3.1.1, downloading Eclipse IDE for Java developers. Note that if you download Eclipse Classic or Eclipse for Java EE Developers, you will not need to install the PDE plugin (PDE is included in those Eclipse packages).

For using the Eclipse Update feature, be sure that you're executing Eclipse with a user with writing privileges on the Eclipse installation folder(Holzner, 2004, pp. 133-138).

Download and install the latest Java Software Development Kit (JDK) from sun.com: http://java.sun.com/javase/downloads/

Download and install the latest Eclipse IDE for Java Developers: http://www.eclipse.org/downloads/

Download and install Subclipse from within Eclipse, see http://subclipse.tigris.org/servlets/ProjectProcess?pageID=p4wYuA.

Download and install the PDE tools from within Eclipse (for Eclipse Ganymede (version 3.4) and (maybe) above, see the next listitem):

Help > Software Updates > Find and Install...

Select 'Search for new features to install', click Next.

Select 'The Eclipse Project Updates', click Finish.

Select a nearby mirror if asked.

Select The Eclipse Project > Eclipse SDK Eclipse 3.3.1.1 > Eclipse PDE Plug-in Developer Resources 3.3.2......., Next, Next, Install. Remark MVW: I had to install "Eclipse Plug-in Development Environment", too.

Restart Eclipse.

If you're using Eclipse Ganymede (which is version 3.4) the installation process of PDE Tools is slightly different:

Go to Help -> Software Updates... (if you get this error on Linux "Cannot launch the Update UI...", then enable the classic update in Preferences > General > Capabilities, then follow the previous method).

Go to the tab called "Available software"

Open "Ganymede update site". Open "Java Development Tools". Check the appropriate package (Eclipse Java Development Tools) and click the button "Install". Maybe you need to install the Eclipse Plug-in Development Environment too, I (Shurakai) am not quite sure about that. Anyway, I installed them.

Restart Eclipse

If you're using Eclipse Galileio (3.5) it looks like this:

Go to Help -> Install New Software.

In the dropdown box, select "The Eclipse Project ...