Baca dalam bahasa Inggris

Bagikan melalui

Tingkatkan ke .NET.NET Aspire 9.0

  • Artikel
Memilih lingkungan pengembangan

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

Tip

Jika Anda baru menggunakan .NET.NET Aspire, tidak ada alasan untuk meningkatkan apa pun. Untuk informasi selengkapnya, lihat penyiapan dan alat .NET.NET Aspire.

Prasyarat

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

Catatan

Jangan ragu untuk menghapus .NET.NET Aspire beban kerja karena Anda tidak akan lagi membutuhkannya.

.NET CLI 
dotnet workload uninstall aspire

Untuk informasi selengkapnya, lihat pencopotan beban kerja dotnet .

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:

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

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

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

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

Untuk meningkatkan proyek host aplikasi ke 9.0 dengan , klik kanan proyek di Penjelajah Solusi dan pilih Tingkatkan.

Penting

Jika Asisten Peningkatan belum diinstal, Anda akan diminta untuk menginstalnya.

Asisten Peningkatan menampilkan paket selamat datang. Pilih opsi peningkatan Aspire:

Visual Studio: Halaman selamat datang Asisten Peningkatan dengan proyek host aplikasi .NET Aspire.

Dengan opsi peningkatan Aspire dipilih, Asisten Peningkatan menampilkan komponen target peningkatan yang dapat dipilih. Biarkan semua opsi dicentang dan pilih Pilihan peningkatan:

Visual Studio: Asisten Peningkatan .NET Aspire komponen yang dapat dipilih untuk ditingkatkan.

Terakhir, setelah memilih komponen yang akan ditingkatkan, Asisten Peningkatan menampilkan hasil proses peningkatan. Jika semuanya berhasil, Anda akan melihat tanda centang hijau di samping setiap komponen:

Visual Studio: Peningkatan Asisten .NET Aspire proyek host aplikasi berhasil ditingkatkan.

Untuk meningkatkan proyek host aplikasi .NET.NET Aspire, pastikan Anda telah menginstal Upgrade Assistant CLI. Buka sesi terminal di direktori akar file proyek host aplikasi .NET.NET Aspire, dan jalankan perintah berikut:

.NET CLI 
upgrade-assistant upgrade

Hasilnya bersifat interaktif, meminta Anda untuk memilih jenis peningkatan. Pilih peningkatan Aspire opsi:

.NET CLI 
 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

Gunakan keyboard Anda untuk menavigasi ke atas ↑ atau ke bawah ↓, dan pilih opsi peningkatan Aspire. Asisten Peningkatan meminta konfirmasi akhir. Masukkan Y untuk melanjutkan peningkatan:

.NET CLI 
 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):

Terakhir, setelah proses peningkatan selesai, Asisten Peningkatan menampilkan hasil proses peningkatan:

.NET CLI 
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.

Visual Studio: Perbarui semua paket NuGet untuk solusi .NET Aspire.

Untuk memperbarui proyek host aplikasi Anda, gunakan perintah CLI .NET berikut untuk memperbarui paket Aspire.Hosting.AppHost ke versi 9.0.0:

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

Ketika referensi paket sudah ada, perintah dotnet add package memperbarui referensi ke versi yang ditentukan. Untuk informasi selengkapnya, lihat dotnet menambahkan paket.

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

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

Tip

Anda juga ingin memperbarui paket NuGet di proyek Anda yang lain ke versi terbaru.

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.