Chapter 5. Integrating with Ant

The provided SonargraphReportTask makes it easy to integrate Sonargraph-Build into Apache Ant based builds and generate HTML or XML reports containing info about metrics and issues of a software system. Additionally, using the optional "failSet" element, the Ant build can be marked as failed if certain issues exist.


  1. You need at least Ant 1.8.3 installed.

  2. Set the environment variable ANT_HOME.

  3. Include ANT_HOME/bin in your PATH environment variable.

The following shows the SonargraphReportTask definition:

<taskdef name="sonargraphBuild" 
    <fileset dir="${}/plugins">
      <include name="org.eclipse.osgi_3.1*.jar" />
      <include name="*.jar"/>
    <fileset dir="${}/client" includes="*.jar" />

An example Ant build.xml is provided in the directory <inst-dir>/example/ant. The parameters are the same as for the shell integration described in Chapter 4, Executing from the Command-line.

5.1. Resend Failed Uploads

The task SonargraphResendFailedUploadsTask allows re-attempting an upload of previously failed report uploads. The parameters are the same as for the shell integration. The build file provided in the Sonargraph-Build installation demonstrates the configuration.

Related topics: