Chapter 6. Eclipse Plug-in

Describes the installation and usage of the Jalopy Eclipse Plug-in. Eclipse [Link] is an open platform for tool integration built by an open community of tool providers. Operating under an open source paradigm, with a common public license that provides royalty free source code and world wide redistribution rights, the Eclipse platform provides tool developers with ultimate flexibility and control over their software technology. Please note that the Plug-in also supports other Eclipse based products, like IBM Websphere Application Developer (WSAD), IBM Rational Application Developer (RAD), JBoss Developer Studio, CodeGear JBuilder, Genuitec MyEclipse etc.

Installation

Explains the steps involved to install the Eclipse Plug-in.

System requirements

The Plug-in requires Eclipse 3.0 or later. See the section called “System requirements” for the basic requirements to run Jalopy.

Setup

The Plug-in comes as an executable Jar Archive (JAR) that contains a graphical setup wizard to let you easily install the software. Wizard installation is recommended and explained in detail in the section called “Wizard Installation”.

If you would rather install the Plug-in manually, you have to decompress and copy the appropriate files into the different application and/or settings folders. To decompress the contents of the installer JAR, you can often use the build-in support of your file manager (e.g. Nautilus) or any other software that can handle the ZIP compression format (e.g. 7Zip, WinZip or Stuffit Expander). If you don’t have access to one of the convenience tools, you might resort to the jar command-line application that ships with your Java distribution.

If you’re upgrading from a prior version and want to keep your settings, first copy or rename the current Jalopy settings directory to match the version number of the new release. For instance, if your current settings directory is C:\Documents and Settings\John Doo\.jalopy\1.9 and you’re about to install Jalopy 1.9.3, either copy the directory contents or rename it to C:\Documents and Settings\.jalopy\John Doo\1.9.3. Wizard installation can perform this step automatically.

Make sure Eclipse is not running and remove any present com.​triemax.​jalopy_1.9.3 directory in your Eclipse plugin folder. This folder is usually located in the root directory of your Eclipse installation, e.g. C:\Program Files\Eclipse\plugins\.

Copy the Jalopy Plug-in folder com_triemax.jalopy_1.9.3 from the temporary directory into the Eclipse plugin folder. Then place the two JAR files jalopy-1.9.3.jar and jalopy-eclipse-1.9.3.jar from the temporary directory into the Jalopy Plug-in folder.

If you are running Eclipse 2.1, as a final step delete the file plugin.xml from the Jalopy Plug-in folder and rename the file plugin.xml-2.x.xml to plugin.xml.