Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
GitHub Copilot Modernisierung ist ein GitHub Copilot Agent, mit dem Sie Ihre C++-Projekte aktualisieren und modernisieren können. Es führt Sie durch Bewertung, Lösungsempfehlungen, Codefixes und Validierung innerhalb Visual Studio.
Szenarien
Der Agent stellt End-to-End-Modernisierungsworkflows bereit, die als Szenarien bezeichnet werden. Jedes Szenario führt Sie durch eine bestimmte Art von Modernisierungsaufgabe.
| Szenario | Beschreibung | Beispielaufforderung |
|---|---|---|
| MSVC Build Tools Upgrade (MSBuild) | Aktualisiert MSBuild-basierte Projekte (.sln, .vcxproj) auf eine neuere Version von MSVC Build Tools und behebt Upgrade-bezogene Buildprobleme. |
"Aktualisieren sie meine Projekte, um die neueste installierte Version der MSVC-Buildtools zu verwenden" |
| Upgrade der MSVC-Buildtools (CMake) | Behebt Buildprobleme im Zusammenhang mit Upgrades in Ihren CMake-basierten Projekten nach der Konfiguration des Projekts mit einer neueren Version von MSVC Build Tools. | "Beheben sie alle Buildprobleme, die durch ein Upgrade meines Projekts verursacht werden, um die neueren MSVC-Buildtools zu verwenden" |
Note
Wenn Sie andere Modernisierungsszenarien vorschlagen oder unterstützen möchten, besuchen Sie Entwicklercommunity.
Eine vollständige Referenz zu allen Szenarien finden Sie unter "Szenarien und Fähigkeiten".
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie folgendes haben:
- Visual Studio 2026, Version 18.7 oder höher.
- Ein GitHub Copilot-Abonnement.
- Eine MSBuild-basierte Codebasis (
.sln,.vcxproj) oder eine CMake-basierte Codebasis.
Ausführliche Einrichtungsschritte finden Sie unter Install GitHub Copilot Modernisierung für C++.
So funktioniert es
So starten Sie den Modernisierungsworkflow:
- Öffnen Sie Ihr C++-Projekt oder Ihre Projektmappe in Visual Studio.
- Starten Sie den Agent: Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf Ihre Projektmappe oder das Projekt, und wählen Sie Modernize aus. Oder geben Sie in GitHub-Copilot Chat
@Modernizeein. - Informieren Sie den Agent, was aktualisiert werden soll.
Wenn in Ihrer Visual Studio-Installation die MSVC Build Tools fehlen, die Ihr Projekt derzeit verwendet, sollte der Setup-Assistent angezeigt werden, wenn Sie Ihr Projekt laden. Sie können den Setup-Assistenten verwenden, um entweder die fehlende MSVC-Version zu installieren oder das Ziel auf die installierte MSVC-Version festzulegen. Wenn Sie Projekte neu ausrichten, erhalten Sie eine Meldung in der Infoleiste, über die Sie direkt den Workflow des Modernize-Agents starten können.
Wenn Sie den Agent bitten, Ihr Projekt zu aktualisieren, werden Sie aufgefordert, eine neue Verzweigung zu erstellen, wenn Sie sich in einem Git-Repository befinden. Anschließend wird ein dreistufiger Workflow ausgeführt. Jede Phase erzeugt Markdown-Dateien unter .github/upgrades/{scenarioId} Ihrem Repository, damit Sie überprüfen können, was als Nächstes kommt, bevor Sie fortfahren. Wenn .github/upgrades/{scenarioId} bereits aus einem früheren Versuch vorhanden ist, fragt der Agent, ob Sie fortfahren oder neu beginnen möchten.
Phase 1: Bewertung
Der Agent untersucht Ihre Projektstruktur, Abhängigkeiten und Code-Muster und speichert eine umfassende Analyse in assessment.md. Der Agent stellt außerdem Strategieentscheidungen für Ihre Überprüfung vor, z. B. Upgradestrategie und Kompatibilitätsbehandlung.
Phase 2: Planung
Der Agent konvertiert die Bewertung in eine detaillierte Spezifikation. Die plan.md Datei dokumentiert Upgradestrategien, Umgestaltungsansätze und Risikominderungen.
Phase 3: Ausführung
Der Agent gliedert den Plan in aufeinanderfolgende Aufgaben mit Validierungskriterien in tasks.md. Jeder Vorgang beschreibt eine einzelne Änderung und wie der Agent bestätigt, dass er erfolgreich war.
Flussmodus
Der Agent unterstützt zwei Flussmodi:
- Automatisch: Funktioniert in allen Phasen, ohne anzuhalten und nur bei echten Blockern zu stoppen. Dieser Modus eignet sich am besten für einfache Upgrades.
- Geführt: Hält an jeder Phasengrenze für Ihre Rezension an. Dieser Modus eignet sich am besten für größere oder komplexere Upgrades.
Sie können jederzeit zwischen den Modi wechseln, indem Sie scenario-instructions.md ändern oder den Agenten anweisen, den Modus zu wechseln. Wenn sie im Modus Automatic ausgeführt wird, müssen Sie den Agent möglicherweise mit der Schaltfläche "Abbrechen" im Copilot Chat Eingabeaufforderungsfenster beenden und den Agent anweisen, den Vorgang im Modus Guided fortzusetzen.
Zustandsverwaltung
Der Agent speichert den gesamten Zustand in .github/upgrades/{scenarioId}.
| Datei | Purpose |
|---|---|
assessment.md |
Analyse Ihrer Lösung. |
plan.md |
Geordneter Aufgabenplan. |
tasks.md |
Live-Fortschrittsdashboard. |
scenario-instructions.md |
Beständiger Speicher des Agents. |
execution-log.md |
Audit-Trail aller Änderungen. |
Sie können Visual Studio schließen und später fortsetzen. Der Agent setzt dort fort, wo er aufgehört hat, indem er die Statusdateien liest.
Tip
Wenn Sie über einen längeren Zeitraum an Ihrem Upgrade arbeiten möchten, während Sie andere Arbeiten erledigen, sollten Sie erwägen, den .github/upgrades-Ordner als separate Commits in Ihrem Branch zu committen. Der zugesicherte Systemzustand dient als Backup und ermöglicht es Teammitgliedern, den Upgradefortschritt anzuzeigen. Separate Commits ermöglichen es Ihnen, diese vor dem Mergen Ihres Branches einfach aus Ihrem lokalen Git-Verlauf zu entfernen, wenn sie nicht dauerhaft in Ihrem Repository verbleiben sollen.
Feedback geben
Microsoft wertet Ihr Feedback und verwendet es, um den Agent zu verbessern. Geben Sie Feedback über eine der folgenden Optionen ab:
Verwenden Sie in Visual Studio die optionen Suggest a feature und Report a problem.
Geben Sie ein Problem auf Entwicklercommunity ein.