Apa itu Asisten Peningkatan .NET?
Asisten Peningkatan .NET membantu meningkatkan proyek ke versi .NET yang lebih baru, dan menganalisis kode Anda untuk menemukan dan memperbaiki potensi ketidaksesuaian. Salah satu fokus alat ini adalah membantu memigrasikan proyek dari .NET Framework, .NET Core, atau .NET, ke versi terbaru .NET. Anda menggunakan ekstensi atau alat untuk meningkatkan seluruh proyek .NET, atau beberapa aspek proyek, seperti memigrasikan file konfigurasi dari jenis yang lebih lama ke jenis yang lebih baru.
Asisten Peningkatan .NET didistribusikan sebagai ekstensi Visual Studio atau alat antarmuka baris perintah (CLI).
Menganalisis dan meningkatkan
Asisten Peningkatan .NET mencakup mesin analisis yang memindai proyek Anda dan dependensinya. Setelah pemindaian selesai, laporan dibuat dengan informasi terperinci tentang melakukan peningkatan. Anda dapat menggunakan informasi ini untuk meningkatkan seluruh proyek atau bagian tertentu dari proyek.
Jenis proyek yang didukung
Asisten Peningkatan .NET mendukung peningkatan proyek yang dikodekan dalam C# atau Visual Basic. Jenis proyek berikut didukung:
- ASP.NET
- Azure Functions
- Windows Presentation Foundation
- Formulir Windows
- Pustaka kelas
- Aplikasi konsol
- Formulir Xamarin
- .NET MAUI
- .NET Native UWP
Beberapa produk memberikan panduan tentang cara menggunakan Asisten Peningkatan .NET.
Meningkatkan jalur
Jalur peningkatan berikut didukung:
- .NET Framework ke .NET
- .NET Core ke .NET
- Azure Functions v1-v3 ke v4 terisolasi (menargetkan net6.0+)
- UWP ke WinUI 3
- Versi .NET sebelumnya ke versi .NET terbaru
- 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.
Detail dan opsi peningkatan
Saat pemutakhiran dimulai, wizard memandikan Anda mengonfigurasi beberapa opsi sebelum pemutakhiran dimulai. Berdasarkan jenis proyek yang Anda tingkatkan, wizard menyajikan opsi yang berbeda. Untuk contoh peningkatan proyek, lihat Meningkatkan proyek dengan Asisten Peningkatan .NET.
Bagaimana peningkatan harus dilakukan
Berdasarkan jenis proyek yang Anda tingkatkan, Anda mungkin dapat mengubah performa peningkatan. Jenis proyek memengaruhi opsi mana yang tersedia, dan satu atau beberapa item berikut mungkin hilang:
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
Ini adalah 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 yang ada. Titik akhir dirutekan melalui proyek .NET, sementara semua panggilan lain dikirim ke aplikasi .NET Framework.
Mode ini memungkinkan Anda meningkatkan aplikasi ASP.NET atau pustaka secara perlahan.
Memutakhirkan hasil
Setelah peningkatan selesai, layar status ditampilkan yang menunjukkan semua artefak 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 yang tidak terisi: Alat ini tidak menemukan apa pun tentang artefak yang akan ditingkatkan.
- Tanda centang hijau terisi: Artefak ditingkatkan dan berhasil diselesaikan.
- Tanda peringatan kuning: Artefak telah ditingkatkan, tetapi ada informasi penting yang harus Anda pertimbangkan.
- Red X: Peningkatan artefak tidak berhasil.
Selain itu, tindakan yang dilakukan selama peningkatan dicatat ke jendela Output di bawah sumber Asisten Peningkatan, seperti yang ditunjukkan pada gambar berikut:
Setelah meningkatkan proyek Anda, uji secara menyeluruh!
