Adélia est compatible avec les mécanismes standard d'intégration de données de SONAR, que ce soit via Maven, Ant, ou le Java Runner autonome fourni par SONAR.
L'exemple d'intégration est basé sur le script Maven utilisé par SONAR par défaut.
Vous devez préalablement avoir installé le plugin Adélia sur le serveur SONAR, puis installé et configuré Maven pour accéder au référentiel SONAR (comme décrit dans l'aide en ligne de SONAR) sur le poste effectuant l'analyse.
Vous pouvez ensuite utiliser le script exemple standard, en définissant les propriétés permettant d'accéder au référentiel Adélia, à savoir au minimum (sonar.language = adel) et (sonar.adelia.environ = <nom_environnement>).
Attention :
Les paramètres par défaut de JAVA peuvent être trop restreints en ce qui concerne l'allocation de la mémoire. Il est recommandé de les augmenter, notamment la taille maximale de la pile.
En ce qui concerne l'analyse par Maven, cela peut être fait en définissant la variable d'environnement MAVEN_OPTS.
La valeur recommandée de cette variable pour Adélia est la suivante :
set MAVEN_OPTS=-Xmx512m -XX:MaxPermSize=128m -Xss1m
Exemple
L'exemple suivant reprend le modèle de projet fourni sur le site Sonar en commentant les informations à renseigner et en spécifiant les paramètres supplémentaires nécessaires en rouge, et les paramètres superflus en gris.
Rappel : le build Maven n'est pas utilisé pour Adélia. Toute la section "build" est donc superflue.
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>[ORGANISATION]</groupId>
<artifactId>[ID PROJET]</artifactId>
<name>[NOM PROJET]</name>
<version>[VERSION PROJET]</version>
<build>
<sourceDirectory>[REPERTOIRE SOURCE]</sourceDirectory>
<outputDirectory>[REPERTOIRE OBJETS]</outputDirectory>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.5</source>
<target>1.5</target>
<excludes>
<exclude>**/*.*</exclude>
</excludes>
</configuration>
</plugin>
</plugins>
</build>
<properties>
<sonar.jdbc.url>[URL_JDBC]</sonar.jdbc.url>
<sonar.jdbc.username>[PROFIL]</sonar.jdbc.username>
<sonar.jdbc.password>[MOT_PASSE]</sonar.jdbc.password>
<sonar.language>adel</sonar.language>
<sonar.adelia.environ>[NOM ENVIRONNEMENT]</sonar.adelia.environ>
</properties>
</project>
Paramètres à renseigner :
ORGANISATION |
Nom de l'organisme (ex : Hardis) |
ID PROJET |
Nom interne du projet dans SONAR. Ce nom n'est pas affiché et doit représenter de façon unique votre projet. Ex : test_va.projet_test |
NOM PROJET |
Nom externe du projet. Doit correspondre au nom du projet défini dans le gestionnaire de qualité Adélia. Ex : Projet de test |
VERSION PROJET |
Version de votre projet. Ex : 1.0 |
URL_JDBC |
URL d'accès à la base de données contenant le repository SONAR. |
PROFIL |
Profil de connexion à la base de données. |
MOT_PASSE |
Mot de passe du profil. |
NOM ENVIRONNEMENT |
Nom de l'environnement Adélia. |
Propriétés spécifiques du plugin Adélia :
sonar.language |
obligatoire |
Langage analysé, obligatoirement 'adel' pour Adélia. |
||||||
sonar.sources |
optionnel |
Pour assurer la compatibilité avec SONAR 4.x, le plugin Adélia extrait désormais les sources dans un répertoire lors de la phase d'initialisation. Ce répertoire, par défaut la sous-arborescence "src/main/java" du projet Maven, peut être configuré sur les versions 4 et ultérieures de SONAR. Il est préférable de créer ce répertoire avant de lancer l'analyse. Dans le cas où Adélia le crée automatiquement, la première analyse peut échouer sur certaines versions de SONAR. |
||||||
sonar.adelia.environ |
obligatoire |
Environnement Adélia. |
||||||
sonar.adelia.gen_mode |
optionnel |
Cette option permet de déterminer comment Adélia va recalculer les données de qualité des programmes avant de les intégrer dans Sonar. Valeurs possibles :
Remarque : si vous utilisez SONAR 2.9 à 4.1, le plugin détecte les modifications de la configuration du profil de règle SONAR et force l'analyse en mode "full" si vous avez sélectionné le mode delta et que les paramètres des règles ont été modifiés. Pour les autres versions, il est de votre responsabilité de relancer l'analyse en mode "full" lorsque vous modifiez la configuration de SONAR.
|
||||||
| sonar.adelia.create_objects | optionnel |
Cette option permet de créer les travaux de compilation lors de l'analyse d'un projet. Attention : le plugin n'exécute pas ces travaux, ils sont pris en charge par le gestionnaire de travaux Adélia. Valeurs possibles : "true" "false" (par défaut) |
||||||
| sonar.adelia.locale | optionnel |
Locale à utiliser pour la connexion à Adélia et la génération des messages de violations. Valeurs possibles : "fr" ou "en". Valeur par défaut : "en".
Remplace le paramètre "sonar.violationLocale" de SONAR supprimé avec SONAR 4.1. Celui-ci reste utilisé si le paramètre Adélia n'est pas indiqué et que vous utilisez une version de SONAR antérieure à la version 4.1. |
Pour exécuter l'intégration, vous devez sauvegarder le fichier sous le nom "pom.xml" dans un répertoire, vous positionner dans ce répertoire et lancer la commande "mvn sonar:sonar". Le projet sera automatiquement créé dans SONAR si nécessaire.
Pour l'intégration avec Ant ou avec le Java Runner, le principe de base est le même, il suffit de définir les propriétés spécifiques à Adélia (au minimum langage "adel" et nom de l'environnement) de façon adaptée. ↑ Haut de page