{iframe:src=http://update.sonarsource.org/plugins/clirr.html|width=700|height=250|frameborder=0}
Your browser does not support iframes.
{iframe}

Features

Clirr checks Java libraries for binary and source compatibility with older releases. In a continuous integration process Clirr can automatically prevent accidental introduction of binary or source compatibility problems.

This Sonar plugin measures the number of API break violations between the current sources and the last known stable version of the library in the Maven repository.

Installation

Use Update Center or download plugin into the directory $SONAR_HOME/extensions/plugins/

Configuration

1. Add at least one Clirr rule to your quality profile (Settings > Quality Profiles > select your profile > filter rules on plugin 'Clirr') :
   
   • API Change adds new feature without breaking anything
   • API Change breaks the backward binary compatibility
   • API Change might change runtime expected behavior
2. Define your project as an API project : browse to the project settings and set the property Clirr -> API to true.
3. Analyze your Maven project
4. Browse to the dashboard and look at "API Changes" widget and page.

Known limitations

1. Only Java Maven projects are supported.
2. As Clirr does not report line numbers, violations cannot be displayed in the correct location within the source code
3. Violations of deleted resources/classes are assigned to the project

Changelog