Gambaran umum .NET Upgrade Assistant
Versi baru .NET dirilis sepanjang tahun, dengan rilis utama setahun sekali. Asisten Peningkatan .NET membantu Anda meningkatkan aplikasi dari versi .NET, .NET Core, dan .NET Framework sebelumnya ke versi terbaru.
Asisten Peningkatan .NET adalah ekstensi Visual Studio dan alat baris perintah yang dirancang untuk membantu meningkatkan aplikasi ke versi terbaru .NET.
Masalah yang terkait dengan Asisten Peningkatan .NET dapat diajukan dalam Visual Studio dengan memilih Bantuan>Kirim Umpan Balik>Laporkan Masalah.
Menginstal Asisten Peningkatan
Asisten Peningkatan .NET dapat diinstal sebagai ekstensi Visual Studio atau sebagai alat baris perintah .NET. Untuk informasi selengkapnya, lihat Menginstal Asisten Peningkatan .NET.
Bahasa yang didukung
Bahasa kode berikut didukung:
- C#
- Visual Basic
Proyek yang didukung
Jenis proyek berikut didukung:
- ASP.NET
- Azure Functions
- Windows Presentation Foundation
- Formulir Windows
- Pustaka kelas
- Aplikasi konsol
- .NET Native UWP
- Formulir Xamarin
- .NET MAUI
Meningkatkan jalur
Jalur peningkatan berikut didukung:
- .NET Framework ke .NET
- .NET Core ke .NET
- UWP ke WinUI 3
- Versi .NET sebelumnya ke versi .NET terbaru
- Azure Functions v1-v3 ke v4 terisolasi
- Formulir Xamarin ke .NET MAUI
- Transformasi file XAML hanya mendukung peningkatan namespace layanan. Untuk transformasi yang lebih komprehensif, gunakan Visual Studio 2022 versi 17.6 atau yang lebih baru.
Tingkatkan dengan ekstensi Visual Studio
Setelah Anda menginstal ekstensi Asisten Peningkatan .NET, klik kanan proyek di jendela Penjelajah Solusi, dan pilih Tingkatkan.
Perhatian
Pastikan Anda mencadangkan proyek sebelum memutakhirkan jika Anda tidak menggunakan kontrol sumber.
Tab dibuka yang menyediakan, berdasarkan jenis proyek Anda, gaya peningkatan yang berbeda:
Peningkatan proyek di tempat
Opsi ini meningkatkan proyek Anda tanpa membuat salinan.
Peningkatan proyek berdampingan
Menyalin proyek Anda dan meningkatkan salinan, meninggalkan proyek asli Anda sendiri.
Berdampingan bertambah berdampingan
Pilihan yang baik untuk aplikasi web yang rumit. Meningkatkan dari ASP.NET ke ASP.NET Core membutuhkan sedikit pekerjaan dan kadang-kadang pemfaktoran ulang manual. Mode ini menempatkan proyek .NET di samping proyek .NET Framework Anda yang ada, dan merutekan titik akhir yang diterapkan dalam proyek .NET, sementara semua panggilan lain dikirim ke aplikasi .NET Framework.
Mode ini memungkinkan Anda meningkatkan aplikasi ASP.NET atau Pustaka secara perlahan.
Setelah aplikasi Anda ditingkatkan, layar status ditampilkan yang menampilkan semua artefak yang terkait dengan proyek Anda yang terkait dengan peningkatan. Setiap artefak peningkatan dapat diperluas untuk membaca informasi selengkapnya tentang status tersebut. Daftar berikut ini menjelaskan ikon status:
- Tanda centang hijau terisi: Artefak ditingkatkan dan berhasil diselesaikan.
- Tanda centang hijau yang tidak terisi: Alat ini tidak menemukan apa pun tentang artefak yang akan ditingkatkan.
- Tanda peringatan kuning: Artefak telah ditingkatkan, tetapi ada informasi penting yang harus Anda pertimbangkan.
- Red X: Artefak harus ditingkatkan, tetapi peningkatan gagal.
Selain itu, tindakan yang dilakukan Asisten Peningkatan dicatat ke jendela Output di bawah sumber Asisten Peningkatan, seperti yang ditunjukkan pada gambar berikut:
Setelah meningkatkan proyek, Anda harus mengujinya secara menyeluruh.
Meningkatkan dengan alat CLI
Setelah Anda menginstal alat CLI Asisten Peningkatan .NET, buka jendela terminal dan navigasikan ke direktori yang berisi proyek yang ingin Anda tingkatkan. Anda dapat menggunakan upgrade-assistant --help
perintah untuk melihat opsi yang tersedia yang disediakan CLI.
Perhatian
Pastikan Anda mencadangkan proyek sebelum memutakhirkan jika Anda tidak menggunakan kontrol sumber.
Jalankan alat dengan upgrade-assistant upgrade
perintah , semua proyek dari folder saat ini dan di bawah ini, tercantum. Alat CLI menyediakan cara interaktif untuk memilih proyek mana yang akan ditingkatkan. Gunakan tombol panah untuk memilih item, dan tekan Enter untuk menjalankan item. Pilih proyek yang ingin Anda tingkatkan. Dalam contoh yang disediakan oleh artikel ini, ada empat proyek di bawah folder saat ini:
Selected options
───────────────────────────────────────────────────────────
No options specified, follow steps below to continue
Steps
─────────────────
Source project
─────────────────
Which project do you want to upgrade (found 9)?
> MatchingGame (winforms\MatchingGame\MatchingGame.csproj)
MatchingGame.Logic (winforms\MatchingGame.Logic\MatchingGame.Logic.csproj)
StarVoteControl (csharp\StarVoteControl\StarVoteControl.csproj)
WebSiteRatings (csharp\WebSiteRatings\WebSiteRatings.csproj)
Navigation
Exit
Bergantung pada proyek yang Anda tingkatkan, Anda mungkin disajikan dengan opsi untuk menentukan bagaimana peningkatan harus dilanjutkan:
Peningkatan proyek di tempat
Opsi ini meningkatkan proyek Anda tanpa membuat salinan.
Peningkatan proyek berdampingan
Opsi ini hanya tersedia untuk proyek .NET Framework. Menyalin proyek Anda dan meningkatkan salinan, meninggalkan proyek asli Anda sendiri.
Selected options
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Source project C:\Code\winforms\MatchingGame\MatchingGame.csproj
Steps
───────────────────────────────
Source project / Upgrade type
───────────────────────────────
How do you want to upgrade project MatchingGame?
> In-place project upgrade
Side-by-side project upgrade
Navigation
Back
Exit
Setelah langkah ini, jika ada lebih dari satu kerangka kerja target yang dapat ditingkatkan, Anda akan memilih target:
Selected options
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Source project C:\Code\Work\dotnet\dotnet-docs\docs\core\porting\snippets\upgrade-assistant-wpf-framework\winforms\MatchingGame\MatchingGame.csproj
Ugrade type Inplace
Steps
──────────────────────────────────────────────────
Source project / Ugrade type / Target framework
──────────────────────────────────────────────────
What is your preferred target framework?
> .NET 6.0 (Supported until November, 2024)
.NET 7.0 (Supported until May, 2024)
.NET 8.0 (Try latest preview features)
Navigation
Back
Exit
Setelah meningkatkan proyek, Anda harus mengujinya secara menyeluruh.