Full documentation for SonarQube has moved to a new location: http://docs.sonarqube.org/display/SONAR

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This page describes how to integrate SonarQubeTM into a build script for Apache Ant.

Prerequisites

You must have previously installed the Sonar SonarQubeTM Ant Task and read Analyzing Code Source.

Note
titleSonar Ant Task 2.0+

This page describes how to use the Sonar Ant Task 2.0+

Usage

Simple Project

Define a new Sonar sonar Ant target in your Ant build script:

Code Block
titlebuild.xml
languagehtml/xml
langxml
...
<!-- Define the SonarQube global properties (the most usual way is to pass these properties via the command line) -->
<property name="sonar.jdbc.url" value="jdbc:mysql://localhost:3306/sonar?useUnicode=true&amp;characterEncoding=utf8" />
<property name="sonar.jdbc.username" value="sonar" />
<property name="sonar.jdbc.password" value="sonar" />
...
 
<!-- Define the SonarQube project properties -->
<property name="sonar.projectKey" value="org.codehaus.sonar:example-java-ant" />
<property name="sonar.projectName" value="Simple Java Project analyzed with the SonarSonarQube Ant Task" />
<property name="sonar.projectVersion" value="1.0" />
<property name="sonar.language" value="java" />
<property name="sonar.sources" value="src" />
<property name="sonar.binaries" value="build/*.jar" />
...

<!-- Define the SonarQube target -->
<target name="sonar">
	<taskdef uri="antlib:org.sonar.ant" resource="org/sonar/ant/antlib.xml">
		<!-- Update the following line, or put the "sonar-ant-task-*.jar" file in your "$HOME/.ant/lib" folder -->
		<classpath path="path/to/sonar/ant/task/lib/sonar-ant-task-*.jar" />
	</taskdef>

	<!-- Execute Sonar -->
	<sonar:sonar />
</target>

...

Run the following command from the project base directory to launch the analysis:

Code Block
ant sonar

Security

Since SonarQubeTM 3.4, if a project cannot be accessed anonymously, the sonar.login and sonar.password properties are required to run an analysis on this project. These properties have to be set to the credentials of a user having the User role on this project. You can set them either:

...

A project cannot be anonymously accessed when either:

Sample Projects

To help you getting started, a simple project sample is available on github that can be browsed or downloadedprojects/languages/java/ant/java-ant-simple

Multi-module Project

The configuration for parent and modules must be done in the parent build.xml file:

...

  • Modules with the same structure: projects/multi-module/ant/java-ant-modules-same-structure
  • Modules with different structures: projects projects/multi-module/ant/java-ant-modules-different-structures

Multi-module and Multi-language Project

Since SonarQubeTM 3.3, it is possible to run an analysis on a multi-module project whose modules contains source code from different languages.

...

To help you getting started, a multi-language project sample is available on github that can be browsed or downloaded: projects projects/languages/multi-language/multi-language-java-javascript-ant

Advanced Usage

Additional analysis parameters can be defined in the build.xml file or through command-line parameters. 

Migrating from

...

SonarQubeTM Ant Task 1.X to

...

SonarQubeTM Ant Task 2.0

The Sonar SonarQubeTM Ant Task 2.0 can run analyses from configuration files designed for Sonar SonarQubeTM Ant Task 1.X.

This compatibility mode is automatically activated. But we highly recommend you to migrate to the new format as this compatibility mode will be dropped sooner or later in the next versions.