.NET .NET Aspire 9.0'a yükseltme

.NET .NET Aspire 9.0 genel kullanıma sunuldu. Bu makalede, mevcut .NET Aspire 8.x projelerinizi .NET Aspire 9.0'a güncelleştirme adımlarını öğreneceksiniz. Projelerinizi .NET.NET Aspire 9.0'a güncelleştirmenin birkaç yolu vardır:

• Projelerinizi el ile .NET.NET Aspire 9.0 sürümüne yükseltin.
• Projelerinizi .NET 9.0'a yükseltmek için .NET Aspire kullanın.

Önkoşullar

Projelerinizi .NET.NET Aspire 9.0'a yükseltmeden önce aşağıdaki önkoşullara sahip olduğunuzdan emin olun:

• En son araçlarıyükleyin.
• .NET .NET Aspire SDKkullanın.

dotnet workload uninstall aspire

.NET .NET Aspire iş yükünü kaldırmazsanız ve yeni .NET.NET Aspire SDK ve şablonlarını kullanıyorsanız hem .NET Aspire 8.0 hem de .NET Aspire 9.0 şablonlarını görürsünüz.

.NET .NET Aspire 9.0'a el ile yükseltme

Projelerinizi .NET.NET Aspire 9.0'a yükseltmek için proje dosyalarınızı güncelleştirmeniz gerekir. Aşağıdaki adımlar işlemde size yol gösterir:

• Yeni .NET 9.0 SDK'sını (.NET Aspire) kullanmak için Aspire.AppHost.Sdk proje dosyanızı düzenleyin.
• Proje dosyalarınızdaki NuGet paketlerini en son sürümlere güncelleştirin.
• Program.cs dosyanızı yeni API'leri kullanacak şekilde ayarlayın ve eski API'leri kaldırın.

Uygulama ana bilgisayar proje dosyanızı düzenleme

Uygulama ana bilgisayar projenizi .NET.NET Aspire 9.0 sürümüne yükseltmek için proje dosyanızı yeni 📦Aspirekullanacak şekilde güncelleştirmeniz gerekir. 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>

İsteğe bağlı olarak hedef çerçeve adını (TFM) yükseltin

.NET Aspire 9.0, .NET 9.0 üzerinde çalışır, ancak .NET 8.0'da da çalıştırabilirsiniz. Başka bir deyişle, .NET Aspire SDK'sını kullanıyor ve sürüm 9.0 paketlerini işaret ediyor olsanız bile, hala 8.0 .NET'i hedefleyebilirsiniz. .NET Aspire 9.0 projenizi .NET 9.0 üzerinde çalıştırmak istiyorsanız, proje dosyanızdaki TargetFramework özelliğini güncelleştirmeniz gerekir:

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

TFM'ler hakkında daha fazla bilgi için bkz. SDK stili projelerde hedef çerçeveler : En son sürümler.

Genel olarak uygulama barındırıcı proje farklılıkları

Önceki adımların tümünü izlediyseniz, uygulama ana bilgisayar proje dosyanız şu şekilde görünmelidir:

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

Değişiklikler arasında Aspire.AppHost.Sdkeklenmesi, TargetFramework özelliğinin net9.0olarak güncelleştirilip Aspire.Hosting.AppHost paketinin 9.0.0sürümüne güncelleştirilerek eklenmesi yer alır.

Program.cs dosyanızı ayarlama

9.0'ın kullanıma sunulmasıyla birlikte,bazı hataya neden olan değişiklikler vardır. Bazı API'ler başlangıçta deneysel (ExperimentalAttribute) olarak işaretlendi ve şimdi kaldırıldı, diğer API'ler ise yeni değiştirme API'leriyle ilgili ayrıntılarla ObsoleteAttribute olarak ilişkilendirildi. yeni API'leri kullanmak için Program.cs dosyanızı (ve diğer etkilenen API'leri) ayarlamanız gerekir. Projelerinizi yükseltmek için Yükseltme Yardımcısı'nı kullanıyorsanız, çoğu durumda Program.cs dosyanızı otomatik olarak ayarlar.

.NET .NET Aspire 9.0'daki önemli değişikliklerin tam listesini görmek için bkz. .NET.NET Aspire 9.0'deki önemli değişiklikler.

Yükseltme Yardımcısı'nı kullanma

Yükseltme Yardımcısı, hedeflenen projeleri en son sürüme yükseltmeye yardımcı olan bir araçtır. Yükseltme Yardımcısı'nı yeni kullanıyorsanız, aralarından seçim yapabileceğiniz iki modalite vardır:

• Visual Studio uzantısı sürümü.
• .NET CLI genel araç sürümü.

Yükseltme Yardımcısı'nı nasıl yüklediğinizden bağımsız olarak, .NET Aspire 8.x projelerinizi .NET Aspire 9.0'a yükseltmek için kullanabilirsiniz.

upgrade-assistant upgrade

 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

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

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

NuGet paketlerini güncelleştirme

.NET .NET Aspire çözümünüzdeki en son güncelleştirmelerden yararlanmak için tüm NuGet paketlerini 9.0.0sürümüne güncelleştirin.

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

Uygulama ana bilgisayar projesi güncelleştirildi, proje dosyanız şu şekilde görünmelidir:

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

Yükseltmeyi doğrulama

Herhangi bir yükseltmede olduğu gibi, uygulamanın beklendiği gibi çalıştığından ve tüm testlerin geçtiğinden emin olun. Çözümü derleyin ve çıkış penceresinde öneriler, uyarılar veya hatalar arayın; daha önce sorun olmayan her şeyi giderin. Herhangi bir sorunla karşılaşırsanız, bir GitHub sorunbildirerek bize bildirin.