Che cos'è l'analisi del codice con .NET Upgrade Assistant?
Questo articolo offre una panoramica della funzione di analisi del codice di .NET Upgrade Assistant. L'analisi del codice genera un report basato sulla configurazione del progetto, sulle dipendenze e sul codice. Il report contiene informazioni su potenziali problemi e problemi che possono verificarsi durante l'aggiornamento e quali passaggi è possibile eseguire per risolvere tali problemi.
Tipi di analisi
Nel codice è possibile eseguire due tipi di analisi:
Codice sorgente e impostazioni
Analizza il codice sorgente, la configurazione e le impostazioni.
Dipendenze binarie
Analizza le dipendenze binarie esterne (ad esempio i pacchetti NuGet) per i progetti.
Report
Al termine dell'analisi, viene generato un report del dashboard. Questo report suddivide i risultati in base a progetti, file, eventi imprevisti e punti di storia. È disponibile anche una visualizzazione aggregata per raggruppare i problemi simili indipendentemente dal progetto in cui sono stati rilevati.
Suggerimento
I punti di storia sono un concetto Agile che consente di stimare la complessità e il lavoro necessari per risolvere un problema. Per altre informazioni, vedere la sezione Punti di storia dell'evento imprevisto.
Ogni problema nel report è categorizzato in base alla gravità per facilitare l'assegnazione delle priorità alle correzioni necessarie. I problemi sono obbligatori o facoltativi. I problemi obbligatori bloccano l'aggiornamento. I problemi facoltativi offrono l'opportunità di eseguire l'aggiornamento a una funzionalità, una libreria o un miglioramento del codice più recente.
Le sezioni seguenti descrivono in dettaglio le aree del report.
Dashboard
La pagina Dashboard fornisce una visualizzazione degli eventi imprevisti rilevati dall'analisi, raggruppati in pannelli:
Riepilogo
Progetti
Questo è il numero di progetti in cui è stato rilevato un evento imprevisto.
Problemi
Numero di regole univoce attivate durante l'analisi. Ogni problema ha un proprio punto di gravità e di storia, insieme a ogni istanza rilevata (evento imprevisto).
Eventi imprevisti
Un evento imprevisto è un'istanza di un problema rilevato in una posizione specifica, ad esempio una parte di codice o un file binario. Ogni evento imprevisto contiene le informazioni contestuali che hanno attivato il problema.
Punti storia
Numero totale di punti di storia necessari per completare l'aggiornamento. Per altre informazioni sul punto di un brano, vedere la sezione Punti di storia dell'evento imprevisto.
Gravità e categorie
Questi due pannelli mostrano grafici che raggruppano gli eventi imprevisti in base alla gravità e alla categoria. Per altre informazioni sulla gravità, vedere la sezione Gravità dell'evento imprevisto .
Progetti
La pagina Progetti suddivide i problemi, gli eventi imprevisti e i punti di storia per progetto. Ogni progetto è un collegamento che apre un report drill-down filtrato in base al progetto.
Problemi di aggregazione
La pagina Problemi di aggregazione descrive in dettaglio ogni problema attivato. Ogni problema può essere espanso per elencare ogni evento imprevisto del problema. La colonna Stato consente di tenere traccia dei problemi risolti o ritenuti non applicabili.
Gravità dell'evento imprevisto
Ogni evento imprevisto del problema ha una gravità associata, che potrebbe bloccare l'aggiornamento. La gravità consente di comprendere cosa deve essere aggiornato affinché l'aggiornamento abbia esito positivo.
| Gravità | Descrizione |
|---|---|
| Obbligatorio | Deve essere risolto. Il processo di aggiornamento potrebbe gestire questi problemi, ad esempio l'aggiornamento del runtime del framework di destinazione (TFM). |
| Facoltativo | Questi non dovrebbero rappresentare un problema con l'aggiornamento, ma è consigliabile prenderne in considerazione la risoluzione prima o dopo l'aggiornamento. |
| Potential | Problemi che potrebbero causare problemi dopo l'aggiornamento, se non vengono affrontati ora. |
| Informazioni | Informazioni aggiuntive relative all'aggiornamento. |
Punti della storia degli eventi imprevisti
Ogni evento imprevisto del problema ha un punto di storia associato. Un punto di storia è un'unità di misura per misurare la complessità di un evento imprevisto, che consente di stimare il tempo necessario per risolvere l'evento imprevisto. .NET Upgrade Assistant definisce i valori dei punti di brano nella tabella seguente:
| Punti della storia | Dimensione |
|---|---|
| 1 | Semplice |
| 3 | Complex |
| 5 | Riprogettazione |
| 7 | Riprogettazione |
| 13 | Sconosciuto |
