Tingkatkan ke .NET.NET Aspire 9.0

.NET .NET Aspire 9.0 sekarang tersedia secara umum. Dalam artikel ini, Anda mempelajari langkah-langkah yang terlibat dalam memperbarui proyek .NET Aspire 8.x yang ada ke .NET Aspire 9.0. Ada beberapa cara di mana Anda dapat memperbarui proyek Anda ke .NET.NET Aspire 9.0:

• Tingkatkan proyek Anda secara manual ke .NET.NET Aspire 9.0.
• Gunakan Upgrade Assistant untuk meningkatkan proyek Anda ke .NET.NET Aspire 9.0.

Prasyarat

Sebelum meningkatkan proyek ke .NET.NET Aspire 9.0, pastikan Anda memiliki prasyarat berikut:

• Instal alat terbaru.
• Gunakan .NET.NET Aspire SDK.

dotnet workload uninstall aspire

Jika Anda tidak menghapus instalan beban kerja .NET.NET Aspire, dan Anda menggunakan SDK .NET.NET Aspire dan templat baru, Anda akan melihat templat .NET Aspire 8.0 dan .NET Aspire 9.0.

Tingkatkan secara manual ke .NET.NET Aspire 9.0

Untuk meningkatkan proyek Anda ke .NET.NET Aspire 9.0, Anda perlu memperbarui file proyek Anda. Langkah-langkah berikut memandu Anda melalui proses:

• Edit file proyek host aplikasi Anda untuk menggunakan SDK 9.0 baru ().
• Perbarui paket NuGet dalam file proyek Anda ke versi terbaru.
• Sesuaikan file Program.cs Anda untuk menggunakan API baru dan hapus API yang sudah usang.

Mengedit file proyek host aplikasi Anda

Untuk meningkatkan proyek host aplikasi Anda ke .NET.NET Aspire 9.0, Anda perlu memperbarui file proyek Anda untuk menggunakan 📦Aspirebaru. 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>

Secara opsional meningkatkan moniker kerangka kerja target (TFM)

.NET Aspire 9.0 berjalan pada .NET 9.0, tetapi Anda juga dapat menjalankannya pada .NET 8.0. Dengan kata lain, hanya karena Anda menggunakan .NET Aspire SDK, dan menunjuk ke paket versi 9.0, Anda masih dapat menargetkan .NET 8.0. Jika Anda ingin menjalankan proyek .NET Aspire 9.0 di .NET 9.0, Anda perlu memperbarui properti TargetFramework dalam file proyek Anda:

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

Untuk informasi lebih lanjut tentang TFM, lihat Kerangka Kerja Target pada proyek bergaya SDK: Versi terbaru.

Perbedaan proyek host aplikasi secara keseluruhan

Jika Anda mengikuti semua langkah sebelumnya, file proyek host aplikasi Anda akan terlihat seperti ini:

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

Perubahan termasuk penambahan Aspire.AppHost.Sdk, pembaruan properti TargetFramework ke net9.0, dan pembaruan paket Aspire.Hosting.AppHost ke versi 9.0.0.

Sesuaikan file Program.cs Anda

Dengan pengenalan .NET.NET Aspire 9.0, ada beberapa perubahan signifikan . Beberapa API awalnya ditandai sebagai eksperimental (dengan ExperimentalAttribute) dan sekarang dihapus, sementara API lain sekarang dikaitkan sebagai ObsoleteAttribute dengan detail tentang API pengganti baru. Anda perlu menyesuaikan file Program.cs Anda (dan API yang berpotensi terpengaruh lainnya) untuk menggunakan API baru. Jika Anda menggunakan Asisten Peningkatan untuk meningkatkan proyek Anda, itu secara otomatis menyesuaikan file Program.cs Anda dalam banyak kasus.

Untuk daftar lengkap perubahan yang melanggar di .NET.NET Aspire 9.0, lihat perubahan Melanggar di .NET.NET Aspire 9,0.

Gunakan Asisten Peningkatan

Upgrade Assistant adalah alat yang membantu meningkatkan proyek yang ditargetkan ke versi terbaru. Jika Anda baru menggunakan Asisten Peningkatan, ada dua modalitas yang dapat dipilih:

• Versi ekstensi Visual Studio.
• Versi alat global CLI .NET.

Terlepas dari cara Anda menginstal Asisten Peningkatan, Anda dapat menggunakannya untuk meningkatkan proyek .NET Aspire 8.x Anda ke .NET Aspire 9.0.

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.

Memperbarui paket NuGet

Untuk memanfaatkan pembaruan terbaru dalam solusi .NET.NET Aspire Anda, perbarui semua paket NuGet ke versi 9.0.0.

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

Dengan proyek host aplikasi yang diperbarui, file proyek Anda akan terlihat seperti ini:

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

Memverifikasi peningkatan

Seperti halnya peningkatan apa pun, pastikan bahwa aplikasi berjalan seperti yang diharapkan dan bahwa semua pengujian lulus. Bangun solusi dan cari saran, peringatan, atau kesalahan di jendela output—atasi apa pun yang tidak menjadi masalah sebelumnya. Jika Anda mengalami masalah, beri tahu kami dengan mengajukan masalah GitHub.