Upgraden naar .NET.NET Aspire 9.0

.NET .NET Aspire 9.0 is nu algemeen beschikbaar. In dit artikel leert u de stappen voor het bijwerken van uw bestaande .NET Aspire 8.x-projecten naar .NET Aspire 9,0. Er zijn een aantal manieren waarop u uw projecten kunt bijwerken naar .NET.NET Aspire 9.0:

• Werk uw projecten handmatig bij naar .NET.NET Aspire 9.0.
• Gebruik de upgradeassistent om uw projecten te upgraden naar .NET.NET Aspire 9.0.

Fooi

Als u nieuw bent met .NET.NET Aspire, is er geen reden om iets te upgraden. Voor meer informatie, zie .NET.NET Aspire instellen en hulpprogramma's.

Voorwaarden

Voordat u uw projecten bijwerken naar .NET.NET Aspire 9.0, moet u ervoor zorgen dat u aan de volgende vereisten voldoet:

• Installeer de meest recente hulpprogramma's.
• Gebruik de .NET.NET Aspire SDK.

Notitie

U kunt de .NET.NET Aspire workload verwijderen omdat u deze niet meer nodig hebt.

dotnet workload uninstall aspire

Voor meer informatie, zie dotnet-workload uninstalleren.

Als u de .NET.NET Aspire workload niet verwijdert en u de nieuwe .NET.NET Aspire SDK- en sjablonen gebruikt, ziet u zowel .NET Aspire 8.0- als .NET Aspire 9.0-sjablonen.

Handmatig upgraden naar .NET.NET Aspire 9.0

Als u uw projecten wilt upgraden naar .NET.NET Aspire 9.0, moet u uw projectbestanden bijwerken. De volgende stappen begeleiden u bij het proces:

• Bewerk uw app-host projectbestand om de nieuwe .NET.NET Aspire 9.0 SDK (Aspire.AppHost.Sdk) te gebruiken.
• Werk de NuGet-pakketten in uw projectbestanden bij naar de nieuwste versies.
• Pas uw Program.cs bestand aan om de nieuwe API's te gebruiken en verouderde API's te verwijderen.

Uw app-hostprojectbestand bewerken

Als u uw app-hostproject wilt upgraden naar .NET.NET Aspire 9.0, moet u het projectbestand bijwerken om de nieuwe 📦Aspirete gebruiken. AppHost.Sdk:

<Project Sdk="Microsoft.NET.Sdk">

+  <Sdk Name="Aspire.AppHost.Sdk" Version="9.0.0" />

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <IsAspireHost>true</IsAspireHost>
    <UserSecretsId>0afc20a6-cd99-4bf7-aae1-1359b0d45189</UserSecretsId>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Aspire.Hosting.AppHost" Version="8.0.0" />
  </ItemGroup>

</Project>

Eventueel de moniker van het doelframework (TFM) upgraden

.NET Aspire 9,0 wordt uitgevoerd op .NET 9.0, maar u kunt het ook uitvoeren op .NET 8,0. Met andere woorden, alleen omdat u de .NET Aspire SDK gebruikt en naar versie 9.0-pakketten verwijst, kunt u zich nog steeds richten op .NET 8.0. Als u uw .NET Aspire 9.0-project wilt uitvoeren op .NET 9.0, moet u de eigenschap TargetFramework bijwerken in het projectbestand:

<Project Sdk="Microsoft.NET.Sdk">

  <Sdk Name="Aspire.AppHost.Sdk" Version="9.0.0" />

  <PropertyGroup>
    <OutputType>Exe</OutputType>
-   <TargetFramework>net8.0</TargetFramework>
+   <TargetFramework>net9.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <IsAspireHost>true</IsAspireHost>
    <UserSecretsId>0afc20a6-cd99-4bf7-aae1-1359b0d45189</UserSecretsId>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Aspire.Hosting.AppHost" Version="9.0.0" />
  </ItemGroup>

</Project>

Zie Doelframeworks in SDK-projecten voor meer informatie over TFM's: Meest recente versies.

Algemene verschillen in app-hostproject

Als u alle voorgaande stappen hebt gevolgd, ziet het projectbestand van de app-host er als volgt uit:

<Project Sdk="Microsoft.NET.Sdk">

+  <Sdk Name="Aspire.AppHost.Sdk" Version="9.0.0" />

  <PropertyGroup>
    <OutputType>Exe</OutputType>
-   <TargetFramework>net8.0</TargetFramework>
+   <TargetFramework>net9.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <IsAspireHost>true</IsAspireHost>
    <UserSecretsId>0afc20a6-cd99-4bf7-aae1-1359b0d45189</UserSecretsId>
  </PropertyGroup>

  <ItemGroup>
-   <PackageReference Include="Aspire.Hosting.AppHost" Version="8.0.0" />
+   <PackageReference Include="Aspire.Hosting.AppHost" Version="9.0.0" />
  </ItemGroup>

</Project>

De wijzigingen omvatten de toevoeging van de Aspire.AppHost.Sdk, de update van de eigenschap TargetFramework aan net9.0en de update van het Aspire.Hosting.AppHost-pakket naar versie 9.0.0.

Uw Program.cs-bestand aanpassen

Met de introductie van .NET.NET Aspire 9.0 zijn er enkele belangrijke wijzigingen. Sommige API's zijn oorspronkelijk gemarkeerd als experimenteel (met de ExperimentalAttribute) en worden nu verwijderd, terwijl andere API's nu worden toegeschreven aan ObsoleteAttribute met details over nieuwe vervangende API's. U moet uw Program.cs-bestand (en mogelijk andere betrokken API's) aanpassen om de nieuwe API's te kunnen gebruiken. Als u de upgradeassistent gebruikt om uw projecten te upgraden, wordt uw Program.cs bestand in de meeste gevallen automatisch aangepast.

Zie voor de volledige lijst met belangrijke wijzigingen in .NET.NET Aspire 9.0 Belangrijke wijzigingen in .NET.NET Aspire 9,0.

De upgradeassistent gebruiken

De upgradeassistent is een hulpprogramma waarmee doelprojecten kunnen worden bijgewerkt naar de nieuwste versie. Als u nieuw bent bij de Upgrade Assistent, zijn er twee modaliteiten waaruit u kunt kiezen:

• De Visual Studio-extensieversie.
• De algemene versie van het cli-hulpprogramma .NET.

Ongeacht hoe u de upgradeassistent installeert, kunt u deze gebruiken om uw .NET Aspire 8.x-projecten te upgraden naar .NET Aspire 9.0.

Als u het hostproject van de .NET Aspire-app wilt upgraden naar .NET Aspire 9.0 met Visual Studio, klikt u met de rechtermuisknop op het project in Solution Explorer- en selecteert u Upgraden.

Belangrijk

Als de Upgradeassistent nog niet is geïnstalleerd, wordt u gevraagd deze te installeren.

De upgradeassistent geeft een welkomstpakket weer. Selecteer de optie Aspire upgrades:

Wanneer de Aspire upgrades optie is geselecteerd, worden de te selecteren doelcomponenten van de upgrade weergegeven. Laat alle opties aangevinkt en selecteer Upgrade selectie.

Ten slotte, nadat u de onderdelen hebt geselecteerd die u wilt upgraden, geeft de Upgrade Assistant de resultaten van het upgradeproces weer. Als alles is gelukt, ziet u groene vinkjes naast elk onderdeel:

Als u het .NET.NET Aspire app-hostproject wilt upgraden, moet u ervoor zorgen dat u de UPGRADE Assistant CLI hebt geïnstalleerd. Open een terminalsessie in de hoofdmap van het .NET.NET Aspire app-hostprojectbestand en voer de volgende opdracht uit:

upgrade-assistant upgrade

De uitvoer is interactief, waarbij u verwacht dat u het upgradetype selecteert. Kies de optie Aspire verbeteringen:

 Selected options
────────────────────────────────────────────────────────────────────────────────────
 Source project     ..\AspireSample\AspireSample.AppHost\AspireSample.AppHost.csproj

 Steps
────────────────────────────────
 Source project / Upgrade type
────────────────────────────────

How do you want to upgrade project AspireSample.AppHost?

> Aspire upgrades
    Upgrade to latest .NET Aspire version (aspire.latest)

  Upgrade project to a newer .NET version
    In-place project upgrade (framework.inplace)

  NuGet upgrades
    NuGet central package management (CPM) (nuget.cpm)

  Navigation
    Back
    Exit

Gebruik het toetsenbord om omhoog te navigeren ↑ of omlaag ↓en selecteer de optie Aspire upgrades. De upgradeassistent vraagt om definitieve bevestiging. Voer Y- in om door te gaan met de upgrade:

 Selected options
────────────────────────────────────────────────────────────────────────────────────
 Source project     ..\AspireSample\AspireSample.AppHost\AspireSample.AppHost.csproj
 Upgrade type       aspire.latest

 Steps
──────────────────────────────────────────
 Source project / Upgrade type / Upgrade
──────────────────────────────────────────

We have gathered all required options and are ready to do the upgrade. Do you want to continue? [y/n] (y):

Nadat het upgradeproces is voltooid, worden de resultaten van het upgradeproces weergegeven met de upgradeassistent:

Finalizing operation...
Complete: 3 succeeded, 0 failed, 7 skipped.

De NuGet-pakketten bijwerken

Als u wilt profiteren van de nieuwste updates in uw .NET.NET Aspire-oplossing, werkt u alle NuGet-pakketten bij naar versie 9.0.0.

Als u uw app-hostproject wilt bijwerken, gebruikt u de volgende .NET CLI-opdracht om het Aspire.Hosting.AppHost-pakket bij te werken naar versie 9.0.0:

dotnet add package Aspire.Hosting.AppHost --version 9.0.0

Wanneer er al een pakketreferentie bestaat, werkt de opdracht dotnet add package de verwijzing naar de opgegeven versie bij. Zie dotnet add packagevoor meer informatie.

Als het app-hostproject is bijgewerkt, ziet het projectbestand er als volgt uit:

<Project Sdk="Microsoft.NET.Sdk">

  <Sdk Name="Aspire.AppHost.Sdk" Version="9.0.0" />

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <IsAspireHost>true</IsAspireHost>
    <UserSecretsId>0afc20a6-cd99-4bf7-aae1-1359b0d45189</UserSecretsId>
  </PropertyGroup>

  <ItemGroup>
-   <PackageReference Include="Aspire.Hosting.AppHost" Version="8.0.0" />
+   <PackageReference Include="Aspire.Hosting.AppHost" Version="9.0.0" />
  </ItemGroup>

</Project>

Fooi

U wilt ook de NuGet-pakketten in uw andere projecten bijwerken naar de nieuwste versies.

De upgrade controleren

Net als bij elke upgrade moet u ervoor zorgen dat de app wordt uitgevoerd zoals verwacht en dat alle tests slagen. Bouw de oplossing en zoek naar suggesties, waarschuwingen of fouten in het uitvoervenster. Los iets op dat eerder geen probleem was. Als u problemen ondervindt, laat het ons dan weten door een GitHub probleem in te dienen.