| Table of Contents |
This page describes how to integrate Sonar into a build script for Apache Ant.
Prerequisites
You must have previously installed the Sonar Ant Task and read Analyzing Code Source.
| Sonar Ant Task 2.0+ This page describes how to use the Sonar Ant Task 2.0+ |
Usage
Simple Project
Define a new Sonar Ant target in your Ant build script:
Run the following command from the project base directory to launch the Sonar analysis:
To help you getting started, a simple project sample is available on github that can be browsed or downloaded: projects/languages/java/ant/java-ant-simple
Multi-module Project
Parent and modules Sonar configuration must be done in the parent build.xml file:
To help you getting started, project samples are available on github that can be browsed or downloaded:
- Modules with the same structure: projects/languages/java/ant/java-ant-modules-same-structure
- Modules with different structures: projects/languages/java/ant/java-ant-modules-different-structures
Known Limitations
- Main sources and unit test sources can not be mixed in the same directory
Migrating from Sonar Ant Task 1.X to Sonar Ant Task 2.0
The Sonar Ant Task 2.0 can run analyses from configuration files designed for Sonar 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.
.

