Compatibility Matrix

All SCM providers currently require the native executable to be installed on the box. For example, for Subversion projects svn executable must be available.

Plugin	1.2	1.3	1.4	1.5
Subversion (1.6+ client)
Git
CVS
Mercurial
Bazaar
Perforce
Team Foundation Server
ClearCase
Accurev
Jazz RTC
MKS Integrity
Visual SourceSafe
CM Synergy
StarTeam

- supported
- not tested
- not implemented

Features

This plugin collects SCM information on each source file to display in the source code viewer the last committer on lines.

Usage & Installation

1. Install from Update Center or download the JAR into the directory /extensions/plugins/
2. Restart Sonar

3. Define the SCM URL of your project (see SCM URL Format). For Git, SVN and Mercurial, the SCM provider is automatically discovered, so what's defined in this property is not taken into account.
   Example for Maven pom.xml:

   Or you can use Project Setting - SCM URL.
   Or specify it via property sonar.scm.url.

4. Go to Global/Project Settings
   
   1. Enable the plugin. This plugin is disabled by default, because it can dramatically increase analysis time of your project.
   2. Specify User (sonar.scm.user.secured) and Password (sonar.scm.password.secured) if needed; if specified then developerConnection will be used, otherwise connection
5. Launch a new quality analysis and the metrics will be fed

 

Performance The first analysis of a project with version 1.4 will last longer than the subsequent analyses.

Known Problems and Limitations

Subversion "Server certificate verification failed: issuer is not trusted"

Add following to .subversion/servers:

CVS anonymous access not working "org.apache.maven.scm.ScmException: password is required."

Try to set empty password for repository in .cvspass. For example:

I use Git and the annotated sources sometimes display a wrong/old author name

The plugin uses 'git blame' command to find out the author of each line. Because a user can commit with different author name/email, it is advised to have a .mailmap file at the root of the repository. This file is used by 'git blame' to find out canonical name/email of each user.

See http://git-scm.com/docs/git-blame#_mapping_authors

Changelog

Release 1.5 (7 issues)
Type	Key	Summary	Priority	Status	Resolution
	SONARPLUGINS-1984	When getting blame information fails, no other retrial is done during next Sonar analysis as long as the source is not updated		Closed	Fixed
	SONARPLUGINS-2009	Metric "scm.hash" should be hidden		Closed	Fixed
	SONARPLUGINS-1952	The mechanism used to determine what source files have been updated from one analysis to another is platform dependent		Closed	Fixed
	SONARPLUGINS-1937	The SCM Activity plugin should be activated by default		Closed	Fixed
	SONARPLUGINS-1936	The SCM Activity Plugin must not be executed when we're analyzing a past quality snapshot with help of 'sonar.projectDate' property		Closed	Fixed
	SONARPLUGINS-1876	Make the "sonar.scm.url" parameter optional when using Git and Subversion		Closed	Fixed
	SONARPLUGINS-1983	Typos in the description of the SCM URL property		Closed	Fixed

Release 1.4 (15 issues)
Type	Key	Summary	Priority	Status	Resolution
	SONARPLUGINS-1896	Always run the SCM Activity plugin with or without local changes.		Closed	Fixed
	SONARPLUGINS-1872	Parallel execution of SCM commands		Closed	Fixed
	SONARPLUGINS-1871	Stop using the changelog/revision to determine if the blame information should be updated on a source file		Closed	Fixed
	SONARPLUGINS-1870	Optimisation of initialisation for project with a lot of changesets		Closed	Fixed
	SONARPLUGINS-1766	Can't integrate SCM Activity into Jenkins with a non-Maven java build		Closed	Fixed
	SONARPLUGINS-1561	Improve loading of changelog on big projects		Closed	Fixed
	SONARPLUGINS-1122	Changelog extractor uses path to Sonar project configuration file		Closed	Fixed
	SONARPLUGINS-1157	SCM Activity plugin fails detecting the revision with mercurial		Closed	Fixed
	SONARPLUGINS-1308	SCM Activity Plugin doesn't work after having changed our SCM		Closed	Fixed
	SONARPLUGINS-1283	CommandLineException: Missing/wrong number of arguments		Closed	Fixed
	SONARPLUGINS-1291	Unable to retrieve TFS changelog		Closed	Fixed
	SONARPLUGINS-1095	Upgrade to Maven SCM 1.7		Closed	Fixed
	SONARPLUGINS-1092	Use API from Maven SCM to validate URL instead of own implementation		Closed	Fixed
	SONARPLUGINS-1094	Scm Activity no longer works for ClearCase		Closed	Fixed
	SONARPLUGINS-1144	Allow blank password for scm user		Closed	Fixed

Release 1.3 (6 issues)
Type	Key	Summary	Priority	Status	Resolution
	SONARPLUGINS-899	Upgrade to Maven SCM 1.5		Closed	Fixed
	SONARPLUGINS-1067	Support Mercurial		Closed	Fixed
	SONARPLUGINS-1085	The analysis must not fail on SCM blame errors		Closed	Fixed
	SONARPLUGINS-1083	Improve message when SCM URL is badly formed		Closed	Fixed
	SONARPLUGINS-1082	Server certificate verification failed		Closed	Fixed
	SONARPLUGINS-1069	SCM Activity plugin sources documentation link points to invalid location		Closed	Fixed

See Sonar 2.7 Upgrade Notes

Release 1.2 (16 issues)
Type	Key	Summary	Priority	Status	Resolution
	SONARPLUGINS-861	Error parsing blame for git		Closed	Fixed
	SONARPLUGINS-854	Poor performance		Closed	Fixed
	SONARPLUGINS-413	Upgrade to Maven SCM 1.4		Closed	Fixed
	SONARPLUGINS-348	Add commit count for past periods		Closed	Fixed
	SONARPLUGINS-499	Use sonar-plugin packaging		Closed	Fixed
	SONARPLUGINS-603	Plugin overwrites local auth credentials		Closed	Fixed
	SONARPLUGINS-601	Support of non-java projects		Closed	Fixed
	SONARPLUGINS-706	Use metrics from Sonar Core		Closed	Fixed
	SONARPLUGINS-877	"Last commit" metric wrongly computed		Closed	Fixed
	SONARPLUGINS-882	Group lines by revision		Closed	Fixed
	SONARPLUGINS-1021	Disable Java implementations of CVS and SVN providers		Closed	Fixed
	SONARPLUGINS-1026	Check local modifications only in source directories		Closed	Fixed
	SONARPLUGINS-1025	Rename plugin properties		Closed	Fixed
	SONARPLUGINS-1020	Override the SCM URL defined in Maven		Closed	Fixed
	SONARPLUGINS-1063	Add the property sonar.scm.verbose		Closed	Fixed
	SONARPLUGINS-1027	Add the property sonar.scm.ignoreLocalModifications		Closed	Fixed

Release 1.1 (4 issues)
Type	Key	Summary	Priority	Status	Resolution
	SONARPLUGINS-373	Support for TFS		Closed	Fixed
	SONARPLUGINS-457	Add Perforce support to the SCM Activity Plugin		Closed	Fixed
	SONARPLUGINS-455	Add support for blame command for Accurev		Closed	Fixed
	SONARPLUGINS-454	Add support for blame command for ClearCase		Closed	Fixed

Release 1.0 (6 issues)
Type	Key	Summary	Priority	Status	Resolution
	SONARPLUGINS-398	CVS implementation does not work anymore		Closed	Fixed
	SONARPLUGINS-374	Maven-scm-ext should be Java 1.4 compatible		Closed	Fixed
	SONARPLUGINS-350	Scm Activity data should not be gathered when injecting historical data		Closed	Fixed
	SONARPLUGINS-371	Add a config parameter to specify or override (pom) the SCM information		Closed	Fixed
	SONARPLUGINS-368	ScmException while parsing generated java files		Closed	Fixed
	SONARPLUGINS-366	Add violations to blame viewer		Closed	Fixed

Release 0.2 (8 issues)
Type	Key	Summary	Priority	Status	Resolution
	SONARPLUGINS-359	Add unit tests for SVN and Git		Closed	Fixed
	SONARPLUGINS-358	Use pure Java implementation for CVS		Closed	Fixed
	SONARPLUGINS-353	Support Bazaar SCM		Closed	Fixed
	SONARPLUGINS-354	Using svn java instead of svn cli		Closed	Fixed
	SONARPLUGINS-351	Enable to gather data from a secured SCM		Closed	Fixed
	SONARPLUGINS-352	Source code data should not appear when plugin is not activated or is incorrectly configured		Closed	Fixed
	SONARPLUGINS-331	Support Mercurial SCM		Closed	Fixed
	SONARPLUGINS-330	Support CVS SCM		Closed	Fixed

Release 0.1 (6 issues)
Type	Key	Summary	Priority	Status	Resolution
	SONARPLUGINS-335	Revision metric		Closed	Fixed
	SONARPLUGINS-333	Show author of each line within source code		Closed	Fixed
	SONARPLUGINS-334	Last commit metric		Closed	Fixed
	SONARPLUGINS-329	Support Git SCM		Closed	Fixed
	SONARPLUGINS-328	Support Subversion SCM		Closed	Fixed
	SONARPLUGINS-322	Create a plugin to report activity in SCM		Closed	Fixed