Installing CodeScan for IntelliJ

Learning Objectives:

After completing this unit, you'll be able to:

• Install CodeScan IntelliJ plugin

• Configure CodeScan Plugin in IntelliJ

• Bind the project with CodeScan

• Find the troubleshooting steps if you encounter IntelliJ CodeScan plugin issues.

Get Started with CodeScan IntelliJ plugin

The CodeScan IntelliJ plugin provides on-the-fly feedback to developers on bugs and quality issues. It is a fully-integrated user experience in the IntelliJ IDE.

The plugin is derived from SonarLint™.

Note: As of now, CodeScan and IntelliJ plugins will not work alongside the SonarLint™ installation, so you must first uninstall SonarLint™.

Prerequisites

Make sure you have the following:

1. IntelliJ IDEA 2022.2 version or above

2. CodeScan for the Cloud:

   • Valid enterprise license or trial (cloud trial only—not available with self-hosted)

3. For Self-Hosted (On-Premises) CodeScan:

   • A working SonarQube™ 9.9+ LTA installation

   • A licensed version of CodeScan 4.4+ plugin to get started (more info) (no trial available with self-hosted/on-premises CodeScan).

4. JDK version 17 or above

5. Latest available Node.js LTS version (v16 as of today)

6. Uninstall SonarLint™ plug-ins. The CodeScan and IntelliJ plug-in will not work alongside the SonarLint™ installation.

Install the CodeScan IntelliJ plugin

1. Launch the IntelliJ IDEA app.

2. Go to Plugins available on the navigation bar on the left side of the screen.

3. Click on the Marketplace tab and search for CodeScan.

4. Click on the Install button and wait for the installation to complete (click on Accept if prompted).

5. Restart IntelliJ to save the changes.

Configuration Of CodeScan Plugin in IntelliJ

After successfully restarting the IntelliJ platform, you will require to configure the CodeScan plugin inside IntelliJ IDEA app.

1. In the IntelliJ IDEA app, go to Settings (Preferences on Mac).

1. Select or double click on Tools and choose CodeScan in the dropdown.

2. You will see another Settings tab under which you can see the (+) icon, click on it.

Note: Make sure you select the checkbox which says "Automatically trigger analysis".

1. A new popup window opens where you need to give the Configuration Name and choose the Connection Type of your preference. Choose the first option if you are using CodeScan cloud default (https://app.codescan.io) instance, and second option if you are on a different CodeScan instance (other than https://app.codescan.io) or server. For example, if you're using the CodeScan European instance with the CodeScan IntelliJ plugin, select the second option i.e., Connect to other CodeScan instances or server and enter https://app-eu.codescan.io in the CodeScan URL section.

1. Click Next. It will now redirect you to another window where you need to enter your CodeScan token.

Note: If you are a CodeScan Cloud user, selecting create token takes you directly to CodeScan Cloud window where you can generate the token. For more information on how to generate a new token for your account, refer to the article: Generate a Security Token

1. Click Next after you enter the token.

2. A new window shows up where you can choose the Organization (If you are part of multiple organizations) which you want to configure.

1. Once you choose the Organization, click on Next and then Finish.

Bind the project with CodeScan

1. In IntelliJ IDEA app, go to File > Settings > CodeScan > Project settings.

2. Select the checkbox which says Bind the project with CodeScan/CodeScan Cloud.

1. Select the Connection under the Project binding that you have just setup or choose from the existing one and the project you want to bind and analyze.

2. Click on Apply, for the changes to take effect.

3. You will now be able to see the errors under the CodeScan window at the bottom in the IDE if there are any, automatically, for the file which is open.

4. If the errors don't show up immediately, reopen the file and you will be able to see the changes.

IntelliJ Troubleshooting

CodeScan Project binding updates gets failed

If the CodeScan update binding is getting failed, try disabling the VPN and antivirus, then try updating the binding again.

If the binding successfully updates, the error occurred due to antivirus blocking CodeScan. Add CodeScan to the list of allowed sites for the antivirus in use.

If the binding still fails, raise a Support Ticket, including the analyzer logs and verbose logs in the attachment.

Note: When Verbose output is enabled, sensitive data may be exposed and care needs to be taken when sharing the logs.