Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
GitHub Copilot upgrade is een GitHub Copilot-agent waarmee u projecten snel en betrouwbaar kunt upgraden naar nieuwere versies van .NET. Het begeleidt u bij de evaluatie, aanbevelingen voor oplossingen, codecorrecties en validatie in Visual Studio, Visual Studio Code, GitHub Copilot CLI en GitHub.com.
Gebruik deze agent om het volgende te doen:
- Voer een upgrade uit naar een nieuwere versie van .NET.
- Moderniseer uw .NET-app, met name wanneer u een upgrade uitvoert van .NET Framework.
- Evalueer de code, configuratie en afhankelijkheden van uw toepassing.
- Controleer of uw app succesvol wordt gebouwd en getest.
Scenarios
De agent biedt meerdere end-to-end moderniseringswerkstromen, scenario's genoemd. Elk scenario is een beheerde werkstroom die u begeleidt bij een specifiek type upgrade of migratie:
| Scenario | Description | Voorbeeldprompt |
|---|---|---|
| .NET versie-upgrade | Upgrades van oudere .NET versies naar .NET 8, 9, 10 of hoger. | "Upgrade mijn oplossing naar .NET 10" |
| Conversie van SDK-stijl | Converteert de verouderde projectindeling naar SDK-stijl. | "Converteren naar SDK-stijl" |
| Newtonsoft.Json-upgrade | Vervangt Newtonsoft.Json door System.Text.Json. | "Upgraden van Newtonsoft.Json" |
| SqlClient-upgrade | Upgrades van System.Data.SqlClient naar Microsoft. Data.SqlClient. | "SqlClient bijwerken" |
| upgrade Azure Functions | Upgrades Azure Functions van een in-proces naar een geïsoleerd werkermodel. | 'Upgrade mijn Azure Functions' |
| Semantic Kernel naar agents | Hiermee wordt Semantic Kernel Agents bijgewerkt naar Microsoft Agent Framework. | "Mijn SK-agents upgraden" |
| Aspire-integratie | Voegt ondersteuning toe voor Aspire inner-loop en Azure-implementatie. | "Toevoegen Aspire aan mijn app" |
| Aspire versie-upgrade | Hiermee worden bestaande Aspire toepassingen bijgewerkt naar nieuwere versies. | "Mijn versie upgraden Aspire " |
| WebForms-to-Blazor-upgrade | Hiermee worden ASP.NET Web Forms toepassingen bijgewerkt naar Blazor. | 'Mijn webformulier-app migreren naar Blazor' |
Voor een volledig overzicht van alle scenario's en meer dan 30 ingebouwde upgradeskills, zie Scenario's en vaardigheden.
Feedback geven
Microsoft hecht waarde aan uw feedback en gebruikt die om de agent te verbeteren. Feedback geven met een van de volgende opties:
Gebruik in Visual Studio de Suggest a feature and Report a problem options.
Dien een probleem in bij de upgradeagent GitHub opslagplaats.
Prerequisites
Stel GitHub Copilot upgrade in uw ontwikkelomgeving in voordat u de agent gebruikt. Zie GitHub Copilot upgrade installeren voor installatiestappen.
.NET-projecten upgraden
De upgradeagent ondersteunt het upgraden van C# en Visual Basic projecten van de volgende typen:
- ASP.NET Core (en gerelateerde technologieën zoals MVC, Razor Pages en Web-API)
- webformulieren ASP.NET
- Blazor
- Azure Functions
- Windows Presentation Foundation (WPF)
- Windows Forms
- WinUI
- .NET MAUI en Xamarin
- Klassebibliotheken
- Consoletoepassingen
- Testprojecten (MSTest, NUnit en xUnit)
Zie Een .NET-app upgraden met GitHub Copilot upgrade om een upgrade te starten.
Ondersteunde upgradepaden
De agent ondersteunt de volgende upgradepaden:
| Source | Target |
|---|---|
| .NET Framework (elke versie) | .NET 8 of hoger |
| .NET Framework (elke versie) | .NET Framework 4.8.1 |
| .NET Core 1.x–3.x | .NET 8 of hoger |
| .NET 5 of hoger | .NET 8 of hoger |
.NET-projecten migreren naar Azure
Gebruik de GitHub Copilot moderniseringsagent om uw .NET toepassingen naar Azure te migreren. De moderniseringsagent verwerkt Azure-specifieke scenario's, zoals databasemigratie, opslag, identiteit, berichten en implementatie.
Upgrades bewaken met het dashboard
Het upgradedashboard biedt een visuele weergave van een upgradesessie in GitHub Copilot CLI en GitHub Copilot app. Gebruik de deelvensters om de algehele voortgang, scenario's, taken, projecten, afhankelijkheden, evaluatieresultaten, upgradeopties en agentactiviteit bij te houden.
Vraag Copilot om het dashboard te openen tijdens een upgradesessie. Het dashboard is momenteel niet beschikbaar in Visual Studio, Visual Studio Code of andere IDE's. Zie Upgrades bewaken met het upgradedashboard voor meer informatie over elk deelvenster.
Hoe werkt het?
Als u een upgrade of migratieproces wilt starten, raadpleegt u:
Start de agent met behulp van een van de volgende methoden:
-
Visual Studio: klik met de rechtermuisknop op de oplossing of het project in Solution Explorer en selecteer Modernize. U kunt ook het GitHub Copilot Chat-venster openen en typen
@Modernize. -
Visual Studio Code: Open het deelvenster GitHub Copilot Chat en typ
@upgrade. -
GitHub Copilot CLI: typ
@upgradegevolgd door uw upgrade- of migratieaanvraag. -
GitHub Copilot-app: Selecteer in de
Upgrade-kiezer.
-
Visual Studio: klik met de rechtermuisknop op de oplossing of het project in Solution Explorer en selecteer Modernize. U kunt ook het GitHub Copilot Chat-venster openen en typen
Laat de agent weten wat er moet worden bijgewerkt of gemigreerd.
Wanneer u de upgradeagent vraagt om uw app te upgraden, Copilot u eerst wordt gevraagd om een nieuwe vertakking te maken als u in een Git-opslagplaats werkt. Vervolgens Copilot uw project beoordeelt en een werkstroom met drie fasen uitvoert. Elke fase produceert Markdown-bestanden in .github/upgrades/{scenarioId} uw repository, zodat u kunt controleren wat er daarna gebeurt voordat u verder gaat. Als .github/upgrades/{scenarioId} al bestaat uit een eerdere poging, Copilot vraagt of u wilt doorgaan of opnieuw wilt beginnen.
Copilot begint met het onderzoeken van uw projectstructuur, afhankelijkheden en codepatronen om een uitgebreide evaluatie te maken. Het assessment.md bestand bevat belangrijke wijzigingen, API-compatibiliteitsproblemen, afgeschafte patronen en het upgradebereik.
Na de evaluatie voert Copilot de volgende drie fasen uit:
Assessment: Copilot onderzoekt uw projectstructuur, afhankelijkheden en codepatronen, en presenteert vervolgens strategiebeslissingen voor uw beoordeling, zoals de upgradestrategie (bottom-up, top-down of all-at-once), benadering van projectupgrades, opties voor technologische modernisering en compatibiliteitsafhandeling. Copilot slaat bevestigde beslissingen op in
upgrade-options.md.Planning: Copilot converteert de evaluatie en uw bevestigde opties naar een gedetailleerde specificatie. Het
plan.mdbestand documenteert upgradestrategieën, herstructureringsmethoden, afhankelijkheidspaden en risicobeperking.Execution: Copilot breekt het plan af in opeenvolgende, concrete taken met validatiecriteria in
tasks.md. Elke taak beschrijft één wijziging en hoe Copilot bevestigt dat deze is geslaagd.
Bewerk een van de Markdown-bestanden .github/upgrades/{scenarioId} om de upgradestappen aan te passen of context toe te voegen voordat u verdergaat.
Upgradestrategieën
Tijdens de evaluatiefase evalueert de agent uw oplossing en wordt een van de volgende strategieën aanbevolen:
| Strategy | Geschikt voor | Description |
|---|---|---|
| Bottom-up | Grote oplossingen met diepe afhankelijkheidsgrafieken | Upgradet bladprojecten eerst en werkt vervolgens omhoog. |
| Van boven naar beneden | Snelle feedback over de hoofdtoepassing | Werkt eerst het toepassingsproject bij en lost vervolgens afhankelijkheden op. |
| Alles tegelijk | Kleine, eenvoudige oplossingen | Hiermee worden alle projecten in één pas bijgewerkt. |
Stroommodi
De agent ondersteunt twee stroommodi die bepalen hoeveel deze pauzeert voor uw invoer:
- Automatisch: De agent werkt door alle fasen zonder te onderbreken en stopt alleen bij echte blokkers. Het meest geschikt voor ervaren gebruikers en eenvoudige upgrades.
- Geleid: De agent onderbreekt bij elke fasegrens, zodat u de evaluatie, het plan en de taken kunt controleren voordat u doorgaat. Het meest geschikt voor gebruikers voor het eerst en complexe oplossingen.
Schakel op elk gewenst moment tussen modi door te zeggen 'onderbreken' (om de begeleide modus in te schakelen) of 'doorgaan' (om de automatische modus in te schakelen).
Toestandbeheer
De agent slaat alle upgradestatussen op in .github/upgrades/{scenarioId}/. De map bevat:
| Bestand | Purpose |
|---|---|
assessment.md |
Analyse van uw oplossing |
upgrade-options.md |
Bevestigde beslissingen voor upgrades |
plan.md |
Geordende taakplanning |
tasks.md |
Livevoortgangsdashboard |
scenario-instructions.md |
Het permanente geheugen van de agent, inclusief voorkeuren, beslissingen en aangepaste instructies |
tasks/{taskId}/task.md |
Bereik en context per taak |
tasks/{taskId}/progress-details.md |
Notities en resultaten per taakuitvoering |
Omdat alle statussen zich in deze map bevinden, kunt u uw IDE sluiten, schakelen tussen sessies of zelfs schakelen tussen ontwikkelomgevingen (bijvoorbeeld starten in VS Code en doorgaan in Visual Studio). De agent gaat verder waar het was gebleven.
Tip
Voer de map door naar uw .github/upgrades/ vertakking. De vastgelegde status fungeert als back-up en stelt teamleden in staat de voortgang van de upgrade te bekijken.
De upgrade uitvoeren
Nadat elke fase is voltooid, controleert en wijzigt u de gegenereerde bestanden indien nodig en geeft u Copilot vervolgens aan om door te gaan naar de volgende fase.
Wanneer u de fase Execution bereikt, laat u Copilot weten om de upgrade te starten. Als Copilot een probleem ondervindt, wordt geprobeerd de oorzaak te identificeren en een oplossing toe te passen. Als Copilot het probleem niet kan oplossen, wordt u om hulp gevraagd. Wanneer u tussenkomt, leert Copilot van de wijzigingen die u aanbrengt en probeert deze automatisch toe te passen als het probleem zich opnieuw voordoet.
Resultaten van de upgrade
Terwijl Copilot elke taak uitvoert, wordt het bestand tasks.md bijgewerkt in .github/upgrades/{scenarioId} met de status van elke stap. Controleer de voortgang door dit bestand te controleren. Copilot maakt een Git-doorvoer voor elk deel van het proces, zodat u wijzigingen kunt terugdraaien of kunt controleren wat er is gewijzigd.
Wanneer de upgrade is voltooid, worden in Copilot volgende stappen in het chatantwoord weergegeven.
Telemetry
Het hulpprogramma verzamelt gegevens over projecttypen, intentie om te upgraden en upgradeduur. De ontwikkelomgeving verzamelt en aggregeert de gegevens en bevat geen door de gebruiker identificeerbare informatie. Zie het Visual Studio-programma voor kwaliteitsverbetering voor meer informatie over het privacybeleid van Microsoft.