Clover-for-Eclipse Installation Guide

Requirements

The Clover-for-Eclipse system requirements are as follows:

You need a valid Clover license file to run Clover. You can obtain a free 30 day evaluation license, purchase a commercial license or apply for a free open source license at http://www.atlassian.com.

Known issues

• Projects initially instrumented/built using an earlier Clover plugin version or build may appear as grey in the Coverage Explorer. To resolve this, perform a clean build on your Clover-instrumented classes and select "Yes" when asked to delete coverage data.

Installation

1. Installing the plugin

You can either install the Clover-for-Eclipse from the live Clover Eclipse update site or from a zipped archive downloaded manually.

1a. Installing the plugin from the live Clover Eclipse update site

In Eclipse 3.4 or Later:

1. Select from the menu "Help | Software Updates" to start the installation process.
2. Click "Available Software"
3. Select "Add Site..." and enter http://update.atlassian.com/eclipse/clover then click OK. This will point Eclipse to the Clover update site from where it will download the plugin and an entry to the sites in the
4. Expand the entry "http://update.atlassian.com/eclipse/clover" and its child entry "Clover 2.3.2" until you see "Clover 2 (for Eclipse 3.2/3.3/3.4)" and "Clover 2 Ant Support (3.2/3.3/3.4)".
5. Click the checkboxes next to "Clover 2 (for Eclipse 3.2/3.3/3.4)" and "Clover 2 Ant Support (3.2/3.3/3.4)" and then click "Install..."
6. The "Install" dialog should now show the two features to install. Click "Finish".
7. You may be asked if you agree to the license terms. If you agree, click the radio button next to 'I accept the license agreement' and click the "Next" button.
8. Finally, you will be asked if you want to restart Eclipse after installing the plugin. Click "Yes" to restart and complete the installation.

1b. Installing the plugin from a downloaded archive of the Clover Eclipse update site

1. Download the most recent Clover Eclipse update site archive from the Clover downloads page

In Eclipse 3.4 or Later:

1. Select from the menu "Help | Software Updates" to start the installation process.
2. Click "Available Software"
3. Select "Add Site...", click "Archive..." and point Eclipse to the location of the Clover Eclipse update site archive. Click OK. This will point Eclipse to the Clover update site from where it will download the plugin and an entry to the sites in the
4. Expand the entry that refers to the archive you've just added and then expand its child entry "Clover 2.3.2" until you see "Clover 2 (for Eclipse 3.2/3.3/3.4)" and "Clover 2 Ant Support (3.2/3.3/3.4)".
5. Click the checkboxes next to "Clover 2 (for Eclipse 3.2/3.3/3.4)" and "Clover 2 Ant Support (3.2/3.3/3.4)" and then click "Install..."
6. The "Install" dialog should now show the two features to install. Click "Finish".
7. You may be asked if you agree to the license terms. If you agree, click the radio button next to 'I accept the license agreement' and click the "Next" button.
8. Finally, you will be asked if you want to restart Eclipse after installing the plugin. Click "Yes" to restart and complete the installation.

2. Installing the license

1. Obtain a valid trial, purchased or opensource license for Clover 2. Licenses can be obtained at http://my.atlassian.com
2. Within Eclipse, select from the menu "Window | Preferences" and click on Clover > License.
3. Paste the contents of your license file into the license text area or select your license file by clicking "Load...".
4. Click Apply. The license summary should now display status, type and message consistent with the type of license you entered.
5. Click OK to close the window.

Uninstallation

In Eclipse 3.4:

1. To uninstall the plugin, from the Eclipse menu select "Help | Software Updates".
2. Select "Installed Software".
3. Find the Clover features in the list - there should be two: "Clover 2 (for Eclipse 3.2/3.3/3.4)" and "Clover 2 Ant Support (for Eclipse 3.2/3.3/3.4)".
4. Select both, right click and select "Uninstall...".
5. Click "Finish" to confirm you want to proceed with the uninstall and disable the features.
6. Finally, you will be asked if you want to restart Eclipse after installing the plugin. Click "Yes" to restart to complete uninstallation.