Was ist Codeanalyse mit dem .NET-Upgrade-Assistenten?

Dieser Artikel enthält eine Übersicht über die Codeanalysefunktion des .NET-Upgrade-Assistenten. Die Codeanalyse generiert einen Bericht basierend auf Der Projektkonfiguration, Abhängigkeiten und Code. Der Bericht enthält Informationen zu potenziellen Problemen und Problemen, die während des Upgrades auftreten können, und welche Schritte Sie ausführen können, um diese Probleme zu beheben.

Analysetypen

Es gibt zwei Arten von Analysen, die Sie für Ihren Code ausführen können:

  • Quellcode und Einstellungen

    Analysiert Den Quellcode, die Konfiguration und die Einstellungen.

  • Binäre Abhängigkeiten

    Analysiert die externen binären Abhängigkeiten (z. B. NuGet-Pakete) für Ihre Projekte.

Berichte

Nach Abschluss der Analyse wird ein Dashboardbericht generiert. In diesem Bericht werden die Ergebnisse nach Projekt-, Datei-, Vorfall- und Storypunkten aufgeschlüsselt. Eine aggregierte Ansicht ist auch verfügbar, um Like-Issues unabhängig davon, in welchem Projekt sie erkannt wurden, zu gruppieren.

Tipp

Story points are an Agile concept that helps estimate komplexität and effort required to fix a problem. Weitere Informationen finden Sie im Abschnitt "Vorfallabschnittspunkte ".

Jedes Problem im Bericht wird nach Schweregrad kategorisiert, um Sie bei der Priorisierung von Korrekturen zu unterstützen, die Sie vornehmen müssen. Probleme sind entweder obligatorisch oder optional. Obligatorische Probleme blockieren das Upgrade. Optionale Probleme bieten die Möglichkeit, ein Upgrade auf ein neueres Feature, eine neuere Bibliothek oder eine Codeerweiterung durchzuführen.

In den folgenden Abschnitten werden die Bereiche des Berichts ausführlich beschrieben.

Dashboard

Die Dashboardseite bietet eine Ansicht der Vorfälle, die von der Überprüfung erkannt wurden, gruppiert in Panels:

Die Ergebnisse des .NET-Upgrade-Assistenten werden analysiert, auf der die Startseite des Dashboards angezeigt wird.

  • Zusammenfassung

    • Projekte

      Dies ist die Anzahl der Projekte, bei denen ein Vorfall erkannt wurde.

    • Probleme

      Die Anzahl der eindeutigen Regeln, die während des Scans ausgelöst wurden. Jedes Problem verfügt über einen eigenen Schweregrad und einen eigenen Verlaufspunkt, zusammen mit jeder erkannten Instanz (Vorfall).

    • Incidents

      Ein Vorfall ist eine Instanz eines erkannten Problems an einem bestimmten Speicherort, z. B. einem Codeteil oder einer Binärdatei. Jeder Vorfall enthält die Kontextinformationen, die das Problem ausgelöst haben.

    • Story-Punkte

      Die Gesamtanzahl der Artikelpunkte, die zum Abschließen des Upgrades erforderlich sind. Weitere Informationen dazu, was ein Storypunkt ist, finden Sie im Abschnitt "Vorfallabschnittspunkte ".

  • Schweregrad und Kategorien

    In diesen beiden Bereichen werden Diagramme angezeigt, in denen die Vorfälle nach Schweregrad und Kategorie gruppiert werden. Weitere Informationen zum Schweregrad finden Sie im Abschnitt "Vorfallschweregrad ".

Projekte

Auf der Seite "Projekte " werden die Probleme, Vorfälle und Storypunkte nach Projekt aufgeschlüsselt. Jedes Projekt ist ein Link, über den ein Drilldownbericht geöffnet wird, der nach diesem Projekt gefiltert ist.

Der .NET-Upgrade-Assistent analysiert die Ergebnisse, auf der die Seite

Aggregierte Probleme

Auf der Seite "Aggregierte Probleme " werden die einzelnen probleme beschrieben, die ausgelöst wurden. Jedes Problem kann erweitert werden, um jeden Vorfall dieses Problems auflisten zu können. Mithilfe der Spalte "Bundesland " können Sie nachverfolgen, welche Probleme Sie behoben oder als nicht anwendbar eingestuft haben.

Die Ergebnisse des .NET-Upgrade-Assistenten analysieren, auf der die Seite

Schweregrad des Vorfalls

Jeder Problemvorfall weist einen zugehörigen Schweregrad auf, der das Upgrade möglicherweise blockiert. Der Schweregrad hilft Ihnen zu verstehen, was aktualisiert werden muss, damit das Upgrade erfolgreich ausgeführt werden kann.

Severity Beschreibung
Obligatorisch. Es muss angegangen werden. Der Upgradeprozess kann diese Probleme für Sie behandeln, z. B. das Aktualisieren der Zielframeworklaufzeit (TARGET Framework Runtime, TFM).
Optional Dies sollte kein Problem mit dem Upgrade darstellen, sie sollten jedoch vor oder nach dem Upgrade berücksichtigt werden.
Potential Probleme, die nach dem Upgrade möglicherweise zu Problemen führen können, wenn Sie sie jetzt nicht beheben.
Informationen Zusätzliche Informationen im Zusammenhang mit dem Upgrade.

Vorfallabschnittspunkte

Jeder Problemvorfall weist einen zugeordneten Storypoint auf. Ein Story-Punkt ist eine Maßeinheit, um die Komplexität eines Vorfalls zu messen, was hilft, die Zeit zu schätzen, die zum Beheben dieses Vorfalls erforderlich ist. Der .NET-Upgrade-Assistent definiert Artikelpunktwerte in der folgenden Tabelle:

Story Points Größe
1 Trivial
3 Complex
5 Neugestaltung
7 Rückbau
13 Unbekannt