Frissítés a .NET.NET Aspire 9.0-ra

Cikk
12/15/2024

.NET .NET Aspire 9.0 már általánosan elérhető. Ebben a cikkben megismerheti a meglévő .NET Aspire 8.x-projektek .NET Aspire 9.0-ra való frissítésének lépéseit. A projektjeit néhány módon frissítheti a .NET.NET Aspire 9.0-ra.

A projektek manuális frissítése a .NET.NET Aspire 9.0-ra.
A Frissítési segéd segítségével frissítheti projektjeit a .NET.NET Aspire 9.0-s verzióra.

Borravaló

Ha új a .NET.NET Aspire-hoz, semmi sem indokolja a frissítést. További információ, lásd a .NET.NET Aspire beállítást és eszközhasználatot.

Előfeltételek

Mielőtt .NET.NET Aspire 9.0-ra frissítené a projekteket, győződjön meg arról, hogy a következő előfeltételek teljesülnek:

Jegyzet

Nyugodtan távolítsa el a .NET.NET Aspire számítási feladatot, mivel már nincs rá szüksége.

dotnet workload uninstall aspire

További információkért lásd: dotnet workload eltávolítása.

Ha nem távolítja el a .NET.NET Aspire számítási feladatot, és az új .NET.NET Aspire SDK- és sablonokat használja, akkor .NET Aspire 8.0-s és .NET Aspire 9.0-s sablonokat is látni fog.

Manuális frissítés a .NET.NET Aspire 9.0-ra

A projektek .NET.NET Aspire 9.0-s verzióra való frissítéséhez frissítenie kell a projektfájlokat. Az alábbi lépések végigvezetik a folyamaton:

Szerkessze az alkalmazáshost projektfájlját, hogy az új .NET.NET Aspire 9.0 SDK-t (Aspire.AppHost.Sdk) használja.
Frissítse a nuGet-csomagokat a projektfájlokban a legújabb verziókra.
Módosítsa a Program.cs fájlt az új API-k használatára, és távolítsa el az elavult API-kat.

Az alkalmazásgazda projektfájljának szerkesztése

Az alkalmazásgazdaprojekt .NET.NET Aspire 9.0-ra való frissítéséhez frissítenie kell a projektfájlt az új 📦Aspirehasználatához. 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>

Igény szerint frissítse a célkeretrendszer azonosítóját (TFM)

.NET Aspire 9.0 .NET 9.0-n fut, de futtatható .NET 8.0-n is. Más szóval, annak ellenére, hogy a .NET Aspire SDK-t használja és a 9.0 verziójú csomagokra mutat, még mindig célozhat a 8.0-s .NET verzióra. Ha a .NET Aspire 9.0-s projektet a .NET 9.0-s verzióján szeretné futtatni, frissítenie kell a TargetFramework tulajdonságot a projektfájlban:

<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.1.0" />
  </ItemGroup>

</Project>

További információ a TFM-ekről: Cél-keretrendszerek SDK-stílusú projektekben: Legújabb verziók.

Az alkalmazásgazda projekt általános eltérései

Ha követte az összes fenti lépést, az alkalmazásgazda projektfájljának a következőképpen kell kinéznie:

<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.1.0" />
  </ItemGroup>

</Project>

A módosítások közé tartozik a Aspire.AppHost.Sdkhozzáadása, a TargetFramework tulajdonság frissítése net9.0, valamint a Aspire.Hosting.AppHost csomag frissítése a 9.0.0verzióra .

A Program.cs fájl módosítása

A .NET.NET Aspire 9.0 bevezetésével vannak kompatibilitástörő változások. Egyes API-k eredetileg kísérletiként (a ExperimentalAttribute) lettek megjelölve, és most már el lettek távolítva, míg más API-k mostantól ObsoleteAttribute az új helyettesítő API-k részleteivel. Az új API-k használatához módosítania kell a Program.cs fájlt (és potenciálisan más érintett API-kat). Ha a frissítési segédet használja a projektek frissítéséhez, az a legtöbb esetben automatikusan módosítja a Program.cs fájlt.

A .NET.NET Aspire 9.0 kompatibilitástörő változásainak teljes listájáért tekintse meg a .NET.NET Aspire 9.0.

A Frissítési segéd használata

A Frissítési segéd olyan eszköz, amely segít a célzott projektek legújabb verziójára való frissítésében. Ha még nem használja a Frissítési segédet, két mód közül választhat:

A Frissítési segéd telepítésétől függetlenül használhatja a .NET Aspire 8.x-projektek .NET Aspire 9.0-s verzióra való frissítésére.

Ha a .NET Aspire alkalmazásgazdaprojektet .NET Aspire 9.0-s verzióra szeretné frissíteni Visual Studio, kattintson a jobb gombbal a projektre Megoldáskezelő, és válassza a Frissítéslehetőséget.

Fontos

Ha a Frissítési segéd még nincs telepítve, a rendszer kérni fogja a telepítést.

A Frissítési segéd egy üdvözlőcsomagot jelenít meg. Válassza a Aspire frissítési lehetőséget:

A Aspire frissítési lehetőség kiválasztásával a Frissítési segéd megjeleníti a választható frissítési célösszetevőket. Hagyja bejelölve az összes beállítást, és válassza Frissítés kiválasztása:

Végül, miután kiválasztotta a frissíteni kívánt összetevőket, a Frissítési segéd megjeleníti a frissítési folyamat eredményeit. Ha minden sikeres volt, az egyes összetevők mellett zöld pipák láthatók:

Az .NET.NET Aspire alkalmazásgazdaprojekt frissítéséhez győződjön meg arról, hogy telepítette a Frissítési segéd parancssori felületét. Nyisson meg egy terminálmunkamenetet a .NET.NET Aspire alkalmazásgazda projektfájljának gyökérkönyvtárában, és futtassa a következő parancsot:

upgrade-assistant upgrade

A kimenet interaktív, és azt várja, hogy válassza ki a frissítés típusát. Válassza a Aspire frissítések lehetőséget:

 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

A billentyűzettel felfelé ↑ vagy lefelé ↓navigálva válaszd a Aspire bővítési lehetőséget. A Frissítési segéd a végleges megerősítést kéri. A frissítés folytatásához adja meg Y:

 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):

Végül a frissítési folyamat befejezése után a Frissítési segéd megjeleníti a frissítési folyamat eredményeit:

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

A NuGet-csomagok frissítése

A .NET.NET Aspire megoldás legújabb frissítéseinek kihasználásához frissítse az összes NuGet-csomagot a 9.0.0verzióra.

Az alkalmazásgazdaprojekt frissítéséhez használja az alábbi .NET CLI-parancsot a Aspire.Hosting.AppHost csomag 9.0.0verzióra való frissítéséhez:

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

Ha már létezik csomaghivatkozás, a dotnet add package parancs frissíti a hivatkozást a megadott verzióra. További információért lásd: dotnet add package.

Az alkalmazásgazdaprojekt frissítésével a projektfájlnak a következőképpen kell kinéznie:

<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.1.0" />
  </ItemGroup>

</Project>

Borravaló

A többi projektben lévő NuGet-csomagokat is frissítenie kell a legújabb verziókra.

A frissítés ellenőrzése

A frissítéshez hasonlóan győződjön meg arról, hogy az alkalmazás a várt módon fut, és minden teszt sikeres lesz. Hozza létre a megoldást, és keressen javaslatokat, figyelmeztetéseket vagy hibákat a kimeneti ablakban – elháríthat mindent, ami korábban nem volt probléma. Ha bármilyen probléma merül fel, tudassa velünk egy probléma bejelentésével a , GitHub,jelzésekkel.

Megosztás a következőn keresztül: