CodeSonar Plug-in for Eclipse: Setting Up

• Prerequisites
• Prerequisite Details
• Install the CodeSonar Plug-in
• Configure the CodeSonar Plug-in
• Uninstalling
• Upgrading CodeSonar
• Next
• Eclipse Plug-in Links

Prerequisites

Before installing the CodeSonar plug-in for Eclipse, ensure that all of the following are installed. For detailed instructions, see Prerequisite Details.

• CodeSonar
• Eclipse, version 4.19 (2021-03) through 4.29 (2023-09), official/supported releases only.
• A Java version compatible with your Eclipse installation.
• If you want to analyze C or C++ projects: the CDT plug-in for Eclipse.
• If you want to analyze Java projects: the JDT plug-in for Eclipse.
  Ensure that your installed JRE version is compatible with JDT plug-in requirements.
• [Windows only] The Microsoft Edge WebView2 runtime.
• [Windows only] If Eclipse is installed in a system folder (such as Program Files), you will need administrative privileges to install the plug-in.

Note

Prerequisite Details

Follow these instructions to ensure all prerequisites for installing the CodeSonar plug-in for Eclipse have been satisfied.

1. If CodeSonar is not already installed, install it now.
2. If Eclipse is not already installed, install it now:
   1. Download the "Eclipse Standard" package for your local operating system from eclipse.org Downloads.
   2. Extract the package on your machine.
   3. Follow any additional instructions provided in the package INSTALL and README files.
3. Start Eclipse.
4. Check to see if the CDT plug-in for Eclipse is installed.
   1. In Eclipse, select Help > About Eclipse.
      An About Eclipse dialog will open.
   2. Click the Installation Details button in the About Eclipse dialog.
      An Eclipse Installation Details dialog will open.
   3. Check: do "C/C++ Development Tools" and "C/C++ Development Tools SDK" appear in the Installed Software tab of the Eclipse Installation Details dialog, with version number 8.0, 8.1, or 8.2?
      • YES: The CDT plug-in is already installed. Go on to check to see if the JDT plug-in for Eclipse is installed.
      • NO: Go on to install the CDT plug-in
5. Install the CDT plug-in (if it is already installed, or if you do not want to analyze any C or C++ projects, go on to check to see if the JDT plug-in for Eclipse is installed).
   1. Determine the URL for the CDT plug-in that matches your Eclipse version by consulting the CDT Downloads page.
   2. Select Help > Install New Software.
      An Install dialog will open.
   3. In the Install dialog, click the Add button (in the upper left corner).
      An Add Repository dialog will open.
   4. In the Location field of the Add Repository dialog, enter the CDT plug-in URL that you determined in step 5a.
   5. Click OK.
      The Install dialog will now show two options:
      • CDT Main Features.
      • CDT Optional Features.
   6. Select both options.
   7. Click Next and work through the remainder of the installation process.
      When you are prompted with the option to restart Eclipse, click Yes.
6. Check to see if the JDT plug-in for Eclipse is installed.
   1. In Eclipse, select Help > About Eclipse.
      An About Eclipse dialog will open.
   2. Click the Installation Details button in the About Eclipse dialog.
      An Eclipse Installation Details dialog will open.
   3. Change to the Plug-ins tab.
   4. Check: does "Eclipse Java Development Tools" appear on the list of installed plug-ins?
      • YES: The JDT plug-in is already installed. Go on to check your Java installation.
      • NO: Go on to install the JDT plug-in
7. Install the JDT plug-in (if it is already installed, or if you do not want to analyze any Java projects, go on to check your Java installation).
   1. Determine the download URL that matches your Eclipse version.
      • For Eclipse Kepler, the URL is:
        http://download.eclipse.org/releases/kepler
      • For other Eclipse versions:
        http://download.eclipse.org/releases/<versionname>
   2. Select Help > Install New Software.
      An Install dialog will open.
   3. In the Install dialog, click the Add button (in the upper left corner).
      An Add Respository dialog will open.
   4. In the Location field of the Add Repository dialog, enter the download URL that you determined in step 7a.
   5. Click OK.
      The Install dialog will now show a list of options.
   6. Click the arrow next to Programming Languages to show further options.
   7. Select Eclipse Java Development Tools.
   8. Click Next and work through the remainder of the installation process.
      When you are prompted with the option to restart Eclipse, click Yes.
8. Check your Java installation. Run the following command line:
   java -version
   • If the command line output indicates that you have a suitable version of Java installed (1.6, 1.7, or 1.8), go on to Installing the CodeSonar Plug-in.
   • If the output indicates that you have another Java version, or that Java is not installed at all, go on to Install Java.
9. Install Java (if a suitable version is already installed, go on to Installing the CodeSonar Plug-in).
   • Follow the instructions at How do I install Java? to install Java on your local machine.
10. Go on to Install the CodeSonar Plug-in.

Install the CodeSonar Plug-in

There are two ways to install the CodeSonar plug-in:

• With the codesonar eclipse-install command.
• Through the CodeSonar configuration tool: main menu option 3.

These instructions use the codesonar eclipse-install approach.

1. Make sure that $CSONAR/codesonar/bin is in your PATH.
   • Otherwise, the codesonar eclipse-install command you construct in the next step will have to specify the path to the codesonar executable.
2. Run
   codesonar eclipse-install path/to/EclipseDir
   where path/to/EclipseDir is the Eclipse installation directory. If the directory path includes spaces, enclose it in double quotes "".
3. Check to make sure that path/to/EclipseDir/dropins/com.codesonar.eclipse.jar now exists.
4. Start Eclipse.
   The top menu bar will now include a CodeSonar menu.
5. Go on to Configure the CodeSonar Plug-in.

Configure the CodeSonar Plug-in

Make sure the CodeSonar plug-in is configured correctly: it needs the CodeSonar installation path in order to perform the CodeSonar build/analysis.

1. From the top menu bar, select CodeSonar > Preferences.
   Eclipse will display the Preferences dialog, with the CodeSonar preferences selected.
2. Check: does the Installation Path field contain the full path to the CodeSonar installation directory?
   • YES: no further configuration actions are needed.
   • NO: add the path now:
     1. Enter the full path to the CodeSonar installation directory in the Installation Path field: either
        • type or paste the path directly in the field, or
        • click Browse, then use the Browse For Folder dialog to navigate to your CodeSonar installation folder and click OK.
     2. Click Apply.
     3. Click OK.

Uninstalling

To uninstall the CodeSonar plug-in for Eclipse, do the following.

1. Remove file path/to/EclipseDir/dropins/com.codesonar.eclipse.jar, where path/to/EclipseDir is the Eclipse installation directory.
2. Restart Eclipse.

When You Upgrade CodeSonar

Once you have upgraded CodeSonar, upgrade your plug-in installation:

1. Uninstall the old version of the plug-in.
2. Install the updated plug-in.
3. Configure the plug-in.

Next

Now that the CodeSonar plug-in is installed and configured, you can:

• Build and Analyze a CodeSonar Project
• Import Analysis Results

Eclipse Plug-in Links

The following sections provide detailed information about installing and using the CodeSonar plug-in for Eclipse.

• Install and Configure the Plug-in (current page)
• Build and Analyze a Project
• Import Analysis Results
• View Analysis Results
• Preferences and Properties
• Eclipse Plug-in Tutorial