Installing CodeScan for VS Code

The CodeScan VS Code plugin provides on-the-fly feedback to developers on bugs and quality issues, it is a fully-integrated user experience in VS Code.

Prerequisites

You will need:

  • For Self Hosted
    • Java 8+
    • A working SonarQube (7.3+) installation
    • A licensed version of CodeScan (4.3+) plugin to get started (see here)
  • For CodeScan Cloud
    • A CodeScan Cloud account (with valid enterprise or trial license)
  • A recent version of VS Code installed (v1.12 or above)
  • If you are working with Salesforce code, you will need the Salesforce Extensions for VS Code or at least the Apex and Visualforce plugins.

Installation

  • In VS Code, go to the Marketplace and download CodeScan.

  • Restart VS Code.

  • In the VS Code User Settings, in the CodeScan section, copy over the codescan.servers and codescan.project settings to the right hand pane.

  • Edit the following in codescan.servers.

  • For CodeScan Cloud

    • Add organizationKey as your CodeScan Cloud organization key (Where do I find this?).
    • Add token with a token generated in here in CodeScan Cloud.
    • Add serverUrl as https://app.codescan.io/
    • Add serverId with a value you will remember.

  • For Self-Hosted CodeScan

    • Add token with a token generated in SonarQube.
    • Add serverUrl as your SonarQube server URL (Default is http://localhost:9000).
    • Add serverId with a value you will remember.

  • Edit the following in codescan.project
    • Add projectKey with the key of the project you would like to use the settings from (Where do I find this?).
    • Add serverId with the serverId you used when editing your codescan.servers settings.

  • Now hit Ctrl+Shift+P (Windows/Linux) or Shift+Command+P(Mac) to open the Command Palette.
  • Type in CodeScan to bring up the CodeScan commands and run “Update CodeScan binding to SonarQube/CodeScan Cloud”. If any changes are made on the SonarQube server you should repeat this step.
  • Open a file, you should see the issues in your code underlined.

VS Code behind a proxy

VS Code extensions can be difficult to use behind a proxy.  

To point CodeScan at the correct proxy, all it takes is a single line in the settings.json file.

"codescan.ls.vmargs": "-Dhttp.proxyHost=your.proxy.host -Dhttp.proxyPort=3333 -Dhttps.proxyHost=your.proxy.host -Dhttps.proxyPort=3333"

Troubleshooting

Some useful debugging information is available under the Output window under the ‘CodeScan’ tab.

CodeScan should automatically find the JRE installed on your computer. If you are having trouble you can specify the path using sonarlint.ls.javaHome variable in your VS Code Settings.

You can check for any serious errors by going to Help > Toggle Developer Tools to bring up the console.

You can also contact us at the CodeScan Support Page. Feel free to ask questions, report issues, and give suggestions.