Partager via


Qu’est-ce que l’analyse du code avec l’Assistant Mise à niveau .NET ?

Cet article fournit une vue d’ensemble de la fonction d’analyse du code de l’Assistant Mise à niveau .NET. L’analyse du code génère un rapport basé sur la configuration, les dépendances et le code de votre projet. Le rapport contient des informations sur les problèmes potentiels et les problèmes que vous pouvez rencontrer pendant la mise à niveau, ainsi que les étapes à suivre pour corriger ces problèmes.

Types d’analyse

Il existe deux types d’analyse que vous pouvez effectuer sur votre code :

  • Code source et paramètres

    Analyse votre code source, votre configuration et vos paramètres.

  • Dépendances binaires

    Analyse les dépendances binaires externes (telles que les packages NuGet) pour vos projets.

Rapports

Un rapport de tableau de bord est généré une fois l’analyse terminée. Ce rapport décompose les résultats par projet, fichier, incident et points d’histoire. Une vue d’agrégation est également disponible pour regrouper les problèmes similaires, quel que soit le projet dans lequel ils ont été détectés.

Conseil

Les points d’histoire sont un concept Agile qui permet d’estimer la complexité et l’effort requis pour résoudre un problème. Pour plus d’informations, consultez la section Points de l’histoire des incidents.

Chaque problème dans le rapport est classé par gravité pour vous aider à hiérarchiser les correctifs que vous devez effectuer. Les problèmes sont obligatoires ou facultatifs. Les problèmes obligatoires bloquent la mise à niveau. Les problèmes facultatifs offrent la possibilité de procéder à une mise à niveau vers une fonctionnalité, une bibliothèque ou une amélioration du code plus récente.

Les sections suivantes décrivent en détail les zones du rapport.

Tableau de bord

La page Tableau de bord fournit une vue des incidents détectés par l’analyse, regroupées dans des panneaux :

Résultats de l’Assistant Mise à niveau .NET Analyse, affichant la page de démarrage du tableau de bord.

  • Résumé

    • Projets

      Il s’agit du nombre de projets où un incident a été détecté.

    • Problèmes

      Nombre de règles uniques qui se sont déclenchées pendant l’analyse. Chaque problème a sa propre gravité et son point d’histoire, ainsi que chaque instance détectée (incident).

    • Incidents

      Un incident est une instance d’un problème détecté à un emplacement spécifique, tel qu’un élément de code ou un fichier binaire. Chaque incident contient les informations contextuelles qui ont déclenché le problème.

    • Story Points

      Nombre total de points d’article requis pour terminer la mise à niveau. Pour plus d’informations sur ce qu’est un point d’histoire, consultez la section Points de l’histoire de l’incident.

  • Gravité et catégories

    Ces deux panneaux affichent des graphiques qui regroupent les incidents par gravité et par catégorie. Pour plus d’informations sur la gravité, consultez la section Gravité de l’incident.

Projets

La page Projets décompose les problèmes, incidents et points d’histoire, par projet. Chaque projet est un lien qui ouvre un rapport d’extraction filtré sur ce projet.

Les résultats de l’Assistant Mise à niveau .NET Analysent, affichant la page « Projets » du tableau de bord.

Problèmes d’agrégation

La page Problèmes d’agrégation détaille chaque problème déclenché. Chaque problème peut être développé pour répertorier chaque incident de ce problème. La colonne État vous aide à suivre les problèmes que vous avez résolus ou jugés non applicables.

Résultats de l’Assistant Mise à niveau .NET Analyser, affichant la page « Problèmes d’agrégation » du tableau de bord.

Gravité de l’incident

Chaque incident de problème a une gravité associée, ce qui peut bloquer la mise à niveau. La gravité vous aide à comprendre ce qui doit être mis à jour pour que la mise à niveau réussisse.

Niveau de gravité Description
Obligatoire Doit être traité. Le processus de mise à niveau peut gérer ces problèmes pour vous, tels que la mise à jour du runtime du framework cible (TFM).
Facultatif Celles-ci ne doivent pas poser de problème avec la mise à niveau, mais vous pouvez envisager de les traiter avant ou après la mise à niveau.
Potential Problèmes susceptibles de provoquer un problème après la mise à niveau, si vous ne les résolvez pas maintenant.
Information Informations supplémentaires relatives à la mise à niveau.

Points d’histoire d’incident

Chaque incident de problème a un point de récit associé. Un point d’histoire est une unité de mesure permettant de mesurer la complexité d’un incident, ce qui permet d’estimer le temps nécessaire pour résoudre cet incident. L’Assistant Mise à niveau .NET définit des valeurs de point de montage par le tableau suivant :

Story points Taille
1 Simple
3 Complexe
5 Refonte
7 Réarchitecture
13 Inconnu