Chapter 6. Eclipse Plug-in

Describes the installation and usage of the Jalopy Eclipse Plug-in.

Eclipse 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.

The homepage can be reached under http://www.eclipse.org/

Installation

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

System requirements

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

Installation

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 folders. To decompress the contents of the installer Jar, you can either use the Jar tool that ships with your Java distribution or any other software that can handle the ZIP compression format (e.g. 7Zip or WinZip).

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.0.4" and you're about to install Jalopy Help, either copy the directory contents or rename it to "C:\Documents and Settings\.jalopy\John Doo\Help". Wizard installation can perform this step automatically.

Make sure Eclipse is not running and remove any present "com.triemax.jalopy_Help" 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_Help" from the temporary directory into the Eclipse plugin folder. Then place the two Jar files "jalopy-Help.jar" and "jalopy-eclipse-Help.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".