Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 13 Next »

Name

C# Plugins Ecosystem

Authors

Fabrice Bellingard (SonarSource), Alexandre Victoor, Jose CHILLAN

Jira

http://jira.codehaus.org/browse/SONARPLUGINS/component/14696

Latest Version

Not released yet

Requires Sonar

2.6 or higher

License

GNU LGPL 3

Sources

http://svn.codehaus.org/sonar-plugins/trunk/csharp/

Download

Not released yet

Description & features

The goal of the C# plugins ecosystem is to make C# a first-class citizen in Sonar - like Java can be. For that purpose, the ecosystem consists of several plugins:

  • C# Core : the core plugin that defines API used by every other plugin in the ecosystem
  • C# Squid : the plugin that parses C# code source, computes metrics and detects copy-paste (distributed by SonarSource as a freeware)
  • C# FxCop : the plugin launches FxCop analyses to detect coding violations relating to potential bugs, tight coupling, globalization, ...
  • C# StyleCop : the plugin launches StyleCop analyses to detect coding violations primarily relating to coding style (formatting, comments, ...)

For information, the plugins have been developed and tested using the following versions of external tools:

Tool

 Version

Web site / install guide

FxCop

10.0

http://www.infoq.com/news/2010/06/FXCop-10

StyleCop

4.4

http://archive.msdn.microsoft.com/sourceanalysis

Installation & global settings

You need to install at least the C# Core plugin to be able to use the other plugins. You may proceed either by downloading the JARs and copying them into the "/extensions/plugins" folder of Sonar, or more simply by using the Update Center in Sonar admin console.

After installing the JARs, and depending on which plugins you selected, you will have to log into Sonar "System Settings" web page and set up the following properties for each plugin:

  • C# Core: ".NET SDK Directory"
  • C# FxCop: "FxCop executable"
  • C# StyleCop: "StyleCop install directory"

Project configuration file

Note for Sonar newbies

Icon

In order to allow Sonar to analyse your C# code base, you need to write a configuration file that gives Sonar information about your project. This configuration file may be of different type, depending on which runner you will use to launch the analysis.

Here are 2 examples of project configuration files with minimal settings (we assume here that Sonar is run in its standalone mode):

"sonar-project.properties" file for the simple Java runner

"pom.xml" file for Maven

With such configuration files, you will be able to analyse a C# project that has a SLN file located in the same directory (the file will be automatically discovered).

Icon

If the SLN file is elsewhere, then you can add the "sonar.dotnet.visualstudio.solution.file" properties to specify its relative path.

Icon

For each plugin, various other properties can be set on the configuration file. You can find them in Sonar "System Settings" web page. (they will be described here as soon as possible)

Launch a Sonar analysis

Once you wrote a configuration file for your project, then you can launch a Sonar analysis by running the following command in the configuration file folder:

Once the process is over, you will be able to browse the results in Sonar Web UI.

Icon

Warning: some tools (like FxCop) require that the C# code has been compiled first.

  • No labels