Freigeben über


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.

Von Bedeutung

Der .NET-Upgrade-Assistent ist offiziell veraltet. Verwenden Sie stattdessen den GitHub Copilot-Modernisierungschat-Agent , der in Visual Studio 2026 und Visual Studio 2022 17.14.16 oder höher enthalten ist. Dieser Agent analysiert Ihre Projekte und Abhängigkeiten, erstellt einen schrittweisen Migrationsplan mit gezielten Empfehlungen und automatisierten Codefixes und führt einen Commit für jede Änderung durch, sodass Sie ein Rollback ausführen können. Es automatisiert allgemeine Portierungsaufgaben – Aktualisieren von Projektdateien, Ersetzen veralteter APIs und Beheben von Buildproblemen – sodass Sie schneller mit weniger manuellem Aufwand modernisieren können.

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 ebenfalls verfügbar, um ähnliche Probleme unabhängig vom Projekt, in dem sie festgestellt wurden, zu gruppieren.

Tipp

"Story Points sind ein agiles Konzept, das hilft, die Komplexität und den Aufwand zu schätzen, der erforderlich ist, um ein Problem zu beheben." Weitere Informationen finden Sie im Abschnitt "Vorfall-Story-Punkte".

Jedes Problem im Bericht wird nach Schweregrad kategorisiert, um Sie bei der Priorisierung von Korrekturen zu unterstützen, die Sie vornehmen müssen. Themen sind entweder verpflichtend oder optional. Obligatorische Probleme blockieren das Upgrade. Optionale Aspekte bieten die Möglichkeit, auf eine neuere Funktion, Bibliothek oder Codeerweiterung aufzurüsten.

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

Dashboard

Die Dashboard-Seite bietet eine Ansicht der Vorfälle, die durch den Scan erkannt wurden, gruppiert in Bereiche:

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 Ort, z. B. einem Codeteil oder einer Binärdatei. Jeder Vorfall enthält die Kontextinformationen, die das Problem ausgelöst haben.

    • Story-Punkte

      Die Gesamtzahl der Story-Punkte, die zur Durchführung des Upgrades erforderlich sind. Weitere Informationen darüber, was ein Storypunkt ist, finden Sie im Abschnitt "Vorfall-Storypunkte".

  • 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, der einen nach diesem Projekt gefilterten Drilldown-Bericht öffnet.

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

Aggregierte Probleme

Auf der Seite "Aggregierte Probleme " werden die einzelnen probleme beschrieben, die ausgelöst wurden. Jedes Problem kann erweitert werden, um alle Vorkommnisse dieses Problems aufzulisten. 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.

Schweregrad 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.

Story-Punkte für Vorfälle

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 Assistant definiert Story-Punktwerte in der folgenden Tabelle:

Story-Punkte Größe
1 Trivial
3 Komplex
5 Neugestaltung
7 Neuarchitektur
13 Unbekannt