La sortie de PVS-Studio 7.04 a coïncidé avec la sortie du plugin Warnings Next Generation 6.0.0 pour Jenkins. Juste dans cette version, Warnings NG Plugin a ajouté la prise en charge de l'analyseur statique PVS-Studio. Ce plugin visualise les données d'avertissement du compilateur ou d'autres outils d'analyse dans Jenkins. Cet article décrira en détail comment installer et configurer ce plugin pour une utilisation avec PVS-Studio, et décrira également la plupart de ses fonctionnalités.
Installation du plugin Warning Next Generation dans Jenkins
Par défaut, Jenkins est situé à . Sur la page principale de Jenkins, en haut à gauche, sélectionnez « Gérer Jenkins » :
Ensuite, sélectionnez l'élément « Gérer les plugins », ouvrez l'onglet « Disponible » :
Dans le coin supérieur droit du champ de filtre, saisissez « Avertissements nouvelle génération » :
Recherchez le plugin dans la liste, cochez la case à gauche et cliquez sur « Installer sans redémarrer » :
La page d'installation du plugin s'ouvrira. Ici, nous verrons les résultats de l'installation du plugin :
Créer une nouvelle tâche dans Jenkins
Créons maintenant une tâche avec une configuration libre. Sur la page principale de Jenkins, sélectionnez « Nouvel élément ». Entrez le nom du projet (par exemple, WTM) et sélectionnez l'élément « Projet Freestyle ».
Cliquez sur « Ok », après quoi la page de configuration des tâches s'ouvrira. Au bas de cette page, dans l'élément « Actions post-build », ouvrez la liste « Ajouter une action post-build ». Dans la liste, sélectionnez « Enregistrer les avertissements du compilateur et les résultats de l'analyse statique » :
Dans la liste déroulante du champ « Outil », sélectionnez « PVS-Studio », puis cliquez sur le bouton Enregistrer. Sur la page des tâches, cliquez sur « Construire maintenant » pour créer un dossier dans l'espace de travail de Jenkins pour notre tâche :
Obtenir les résultats de la construction du projet
Aujourd'hui, je suis tombé sur le projet dotnetcore/WTM dans les tendances Github. Je l'ai téléchargé depuis Github, je l'ai placé dans le répertoire de construction WTM dans Jenkins et je l'ai analysé dans Visual Studio à l'aide de l'analyseur PVS-Studio. Une description détaillée de l'utilisation de PVS-Studio dans Visual Studio est présentée dans l'article du même nom : .
J'ai exécuté le projet dans Jenkins à plusieurs reprises. En conséquence, un graphique est apparu en haut à droite de la page des tâches WTM dans Jenkins et un élément de menu est apparu à gauche. Avertissements PVS-Studio:
Lorsque vous cliquez sur le graphique ou sur cet élément de menu, une page s'ouvre avec la visualisation du rapport de l'analyseur PVS-Studio à l'aide du plugin Warnings Next Generation :
Page de résultats
Il y a deux diagrammes circulaires en haut de la page. À droite des graphiques se trouve la fenêtre graphique. Ci-dessous un tableau.
Le diagramme circulaire de gauche montre le ratio d'avertissements de différents niveaux de gravité, celui de droite montre le ratio d'avertissements nouveaux, non corrigés et corrigés. Il y a trois graphiques. Le graphique affiché est sélectionné à l'aide des flèches de gauche et de droite. Les deux premiers graphiques affichent les mêmes informations que les graphiques et le troisième montre l'évolution du nombre d'alertes.
Vous pouvez sélectionner des assemblées ou des jours comme points du graphique.
Il est également possible de restreindre et d'étendre la plage temporelle du graphique pour afficher les données sur une certaine période :
Vous pouvez masquer les graphiques de certaines métriques en cliquant sur la désignation de la métrique dans la légende du graphique :
Graphique après avoir masqué la métrique « Normal » :
Vous trouverez ci-dessous un tableau affichant les données du rapport de l'analyseur. Lorsque vous cliquez sur un secteur d'un camembert, le tableau est filtré :
Le tableau comporte plusieurs onglets pour filtrer les données. Dans cet exemple, le filtrage par espace de noms, fichier, catégorie (nom de l'alerte) est disponible. Dans le tableau, vous pouvez sélectionner le nombre d'avertissements à afficher sur une page (10, 25, 50, 100) :
Il est possible de filtrer les données par la chaîne saisie dans le champ « Rechercher ». Exemple de filtrage par le mot « Base » :
Dans l'onglet « Problèmes », lorsque vous cliquez sur le signe plus au début de la ligne du tableau, une brève description de l'avertissement s'affichera :
La brève description contient un lien vers un site Web contenant des informations détaillées sur cet avertissement.
Lorsque vous cliquez sur les valeurs dans les colonnes « Package », « Catégorie », « Type », « Gravité », les données du tableau sont filtrées par la valeur sélectionnée. Filtrer par catégorie :
La colonne « Âge » affiche le nombre de builds qui ont survécu à cet avertissement. Cliquer sur la valeur dans la colonne Âge ouvrira la page de construction où cet avertissement est apparu pour la première fois.
Cliquer sur une valeur dans la colonne "Fichier" ouvrira le code source du fichier sur la ligne contenant le code qui a provoqué l'avertissement. Si le fichier ne se trouve pas dans le répertoire de construction ou a été déplacé après la création du rapport, l'ouverture du code source du fichier ne sera pas possible.
Conclusion
Avertissements Next Generation s'est avéré être un outil de visualisation de données très utile dans Jenkins. Nous espérons que la prise en charge de PVS-Studio par ce plugin aidera grandement ceux qui utilisent déjà PVS-Studio et attirera également l'attention des autres utilisateurs de Jenkins sur l'analyse statique. Et si votre choix se porte sur PVS-Studio comme analyseur statique, nous en serons très heureux. Nous t'invitons notre outil.
Si vous souhaitez partager cet article avec un public anglophone, veuillez utiliser le lien de traduction : Valery Komarov. .
Source: habr.com