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 40 Next »

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

 

Table of Contents

 

Prerequisites

  • Ant 1.7.1 or higher
  • Java 1.5 or higher
  • Sonar 2.8 or higher. The server must be up while running the Ant task.

Version compatibility

Ant task

Sonar 2.6

Sonar 2.7

Sonar 2.8

Sonar 2.9 to Sonar 3.0

1.4

(error)

(error)

(tick)

(tick)

1.3

(error)

(error)

(tick)

(tick)

1.2

(error)

(error)

(tick)

(tick)

1.1

(error)

(error)

(tick)

(tick)

1.0

(tick)

(tick)

(tick) but without support of multi-modules

(error)

The way to configure the Sonar Ant task has changed between version 1.0 and version 1.1, so if you must use the Ant task version 1.0, please use this documentation page.

Older versions of Sonar are not supported.

Installation

  1. Download the Sonar Ant Task
  2. Declare the Sonar Ant Task and define the configuration in a common Ant script file :

Analyze project

  1. Define a new sonar Ant target in your Ant build script :

    Icon

    Declaring a XML namespace for Ant tasks is optional but always recommended if you mix tasks from different libraries.

    Icon

    The Definition for key is groupId:artifactId. It has to consist of 2 values separated by colon (":").

    Icon

    For advanced features such as reusing existing unit test reports, you can define advanced parameters. These parameters are set with the <property> nodes of Sonar task.

  2. Execute the following command from the project base directory :

    Icon

    It's recommended to build the project before, usually to get bytecode and unit test reports.

    Icon

    The Sonar Ant task stores all temporary files in a '.sonar' directory which is automatically created by the Ant task in the working directory.

    Icon

    Since version 1.2 you can specify sonar.libraries using path-like structure as following :

Analyse multi-modules project

Let's say that we have a project "Parent" containing two modules "Child1" and "Child2" and we want Sonar to be able to analyse the overall Parent multi-modules project :

The first thing to do is to declare all modules in the build.xml file of the Parent with the "sonar.modules" property :

Known limitation

Icon

Spaces and return carriages are not supported in the sonar.modules property value: see SONARPLUGINS-1853.

 

Then, in each build.xml file of module, the Sonar key and Sonar source directories properties must be defined :

Of course additional but optional Sonar properties can also be defined in each module to provide for instance the binary directories, the list of libraries, ...

You can ask the Sonar task to execute an Ant target on the parent and for each module before collecting those property values. In that case, a new attribute "initTarget" must be added to the Sonar task definition in the build.xml file of the Parent :

Icon

Here is the source code of a sample muli-module Ant project

Use Jacoco with Ant projects

Some additional configuration is required with Ant projects.

The Ant build.xml file must contain a dedicated target to launch either junit or testng unit tests. Let's take the following example with the target "test":

Icon

The nested task always has to declare fork="true", otherwise JaCoCo agent can't be attached. In addition task should declare forkmode="once" to avoid starting a new JVM for every single test case and decreasing execution performance dramatically (unless this is required by the nature of the test cases).

Then, in this example, the value of the parameter "sonar.jacoco.antTargets" must be set to "test". During Sonar analysis, the Sonar Jacoco plugin will take care to attach the Jacoco agent to the JVM and to launch the unit tests. 

Icon

Only specified targets would be executed. So for instance, if "test" target depends on a "compile" target, Jacoco plugin will only execute "test" target without executing first the "compile" target. In such case, a solution can be to update the "sonar" target in order declare a dependency on the "compile" target.

Icon

Here is the source code of a sample Ant+Jacoco project

Limitations

  • Main sources and unit test sources can not be mixed in the same directory

Release Notes

Loading

Release 1.4 (4 issues)

Loading

Release 1.3 (2 issues)

Loading

Release 1.2 (2 issues)

Loading

Release 1.1 (3 issues)

Loading

Release 1.0 (1 issues)

T Key Summary P Status Resolution
New Feature SONARPLUGINS-950 New ANT task to analyze projects Critical Closed Fixed

  • No labels