Clover-for-IDEA Installation Guide

Installing the Plugin from IDEA (recommended)

The easiest way to install Clover-for-IDEA is to select it from IDEA's plugin menu.

1. Launch IntelliJ IDEA.
2. Go to 'File > Settings > IDE Settings > Plugins > Available'.
   In IDEA 9.x, the sequence of options is 'File > Settings > Plugins > Available'.
3. Right click on 'Atlassian Clover for IDEA', then select "Download and Install" from the context menu that appears (alternatively, you can select Clover for IDEA then click the 'Download Plugin' button).
4. Close and re-start IDEA.

You can now begin using Clover for IDEA.

Screenshot: Installing Clover from the IDEA Plugin Menu

Installing the Plugin Manually

You can download the Clover-for-IDEA plugin from Atlassian Downloads and install it manually as follows:

1. Shut down any running instances of IDEA.
2. Remove any previous versions of the the Clover-for-IDEA plugin .jar file from the following plugin installation locations:
   1. IDEA_HOME/plugins (all platforms)
   2. IDEA_HOME/config/plugins (all platforms excepting Mac OS X)
   3. USER_HOME/Library/Application\ Support/IntelliJIDEA70 (Mac OS X only)
3. Copy the downloaded .jar file into the relevant location for your operating system:
   1. IDEA_HOME/plugins (all platforms)
   2. IDEA_HOME/config/plugins (all platforms excepting Mac OS X)
   3. USER_HOME/Library/Application\ Support/IntelliJIDEA70 (Mac OS X only - create the directory if it doesn't exist)
4. Re-start IDEA.

You will need a valid license to activate your plugin.

• Download your clover.license file from http://www.atlassian.com/clover/. Evaluation licenses are available free of charge.
• Open the Clover license dialog in IDEA. Go to 'File > Settings > IDE Settings > Clover License', click 'Load' and select the 'clover.license' file you just downloaded.

Screenshot: The Clover license dialog in IDEA

Configuring compiler settings

JetBrains IDEA 12.0 has a new compiler feature named "external build", which is enabled by default in project settings (File > Settings > Project Settings > Compiler > "Use external build" toggle). The IDEA 12 is supported since Clover version 3.1.8, however the support for "external build" feature is available since Clover version 3.1.12 and IDEA 12.1.1. For older versions, i.e. the combination of Clover 3.1.8-3.1.12 and IDEA 12.0.0-12.1.0 please keep the "external build" feature disabled.

Enabling the "external build" feature

Open the File > Settings > Project Settings > Compiler page.

Use the following state for toggles:

• Use external build - it can be either enabled (the new IDEA12 feature is used) or disabled (the "classic" IDEA build is used)
• Make project automatically - it's strongly recommended to disable this option; enabling it causes frequent compilation and faster growth of Clover database, which might affect performance
• Compile independent modules in parallel - it must be disabled; Clover does not support parallel build; follow the CLOV-1293 for future updates

Known Issues

• If you are using the Maven build tool, you should avoid using the same IntelliJ output directory as Maven does. As Maven uses the target/classes and target/test-classes directories, avoid specifying these ones. The clover.db location for IntelliJ should also be distinct from that used by Maven.

Uninstalling the Plugin

The easiest way to uninstall it is via 'File > Settings > IDE > Plugins'. Just select the Clover IDEA Plugin from the list and click 'Uninstall Plugin'. The removal will take place after you restart IDEA.

To uninstall Clover-for-IDEA manually:

1. Shut down any running instances of IDEA.
2. Delete the 'clover-idea7.jar' file from its installation directory, either IDEA_HOME/config/plugins (all platforms),  IDEA_HOME/plugins (all platforms except Mac OS X) or USER_HOME/Library/Application\ Support/IntelliJIDEA70 (Mac OS X only)
3. Restart IDEA.