Le plugin SONAR Adélia nécessite SONAR 2.12 au minimum.
Attention :
- La version courante du plugin SONAR est compatible avec SONAR 6.7 à 10.x.
Comme les dernières versions de SONAR ne permettent plus de traiter les données de qualité Adélia, le plugin SONAR est désormais associé à un plugin Maven en charge de l'exécution du gestionnaire de qualité Adélia (adelqual-maven-plugin).
Ces plugins nécessitent un JRE 8 ou ultérieur, 32 bits ou 64 bits (ce qui implique que SONAR doit être démarré avec un JRE 8 même pour les versions compatibles JRE 7).
- A noter : les versions antérieures du plugin (1.x et 2.x pour SONAR 2.12 à 6.7) ne sont plus livrées mais restent compatibles avec Adélia Studio 14. Ces versions ont un mode de fonctionnement différent, veuillez vous reporter à la documentation Adélia antérieure.
Étapes de préinstallation
Avec les versions courantes de SONAR, la définition des règles de qualité et le profil de règles par défaut ne sont mis à jour que lors de l'installation initiale du plugin. De plus, les règles sont créées dans la langue par défaut (anglais).
Lors de la première installation, il est possible de définir des variables d'environnement permettant de définir le paramétrage par défaut. Cette opération doit être effectuée avant la première installation du plugin.
Les variables sont les suivantes :
| Nom | Description | Valeur par défaut |
|---|---|---|
| ADELIA_SONAR_PLUGIN_LOCALE | Locale par défaut du profil de règles - français (fr) ou anglais (en) | en |
| ADELIA_SONAR_PLUGIN_EXTENSION_FOLDER | Répertoire de base contenant les fichiers de description des plugins utilisateur | C:\AdeliaPlugins sur plateforme Windows. $(HOME)/AdeliaPlugins sur les systèmes Unix / Linux, $(HOME) référençant le répertoire home du profil démarrant Sonar. |
De plus, si vous utilisez des plugins utilisateurs, le répertoire d'extension et les fichiers de description des plugins doivent être créés avant l'installation dans Sonar.
Installation du plugin
Pour installer le plugin sur la plateforme SONAR, il suffit de copier le fichier "adeliasonarplugin-xxx.jar" du sous-répertoire "quality" de l'installation d'Adélia dans le sous-répertoire "extensions\plugin" de l'installation de SONAR, puis de redémarrer SONAR.
Dans le cas d'une migration, assurez-vous de n'avoir qu'une seule version du plugin dans ce répertoire.
Vous pouvez vérifier l'installation du plugin en allant dans la page de configuration de SONAR : la page principale (profils de configuration) doit référencer un profil "Adelia" de type "Adelia Profile" ou "Profil Adélia", selon la langue du navigateur.
Pour la génération des messages d'erreur liés aux violations, le plugin SONAR Adélia respecte le paramètre "sonar.adelia.locale" de SONAR (onglet "Adélia" dans les paramètres généraux). Les messages sont générés par défaut en anglais. Il vous faudra configurer ce paramètre pour avoir les messages en français.
Mise à jour des plugins utilisateur
Après l'installation, il est possible de changer la langue d'affichage des règles et métriques du plugin Adélia, ou de forcer la mise à jour des plugins utilisateur (prise en compte de nouvelles règles), en effectuant les manipulations suivantes :
- Si le but est de changer la langue du profil de règles, modifiez le paramètre de la locale (sonar.adelia.locale) dans le paramétrage Sonar (Administration / Configuration / Adelia Sonar Plugin).
- Supprimez le fichier du plugin du répertoire d'extensions de Sonar (extensions\plugin).
- Redémarrez Sonar.
- Réinstallez le fichier du plugin dans le répertoire d'extensions de Sonar.
- Redémarrer Sonar à nouveau.
Remarque : aucune donnée de paramétrage, de projets ou donnée liée aux profils personnalisés n'est perdue dans cette opération. ↑ Haut de page