Bagikan melalui

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 meningkatkan proyek dari .NET Framework, .NET Core, atau .NET, ke versi terbaru .NET. Anda menggunakan Asisten Peningkatan .NET untuk meningkatkan seluruh proyek .NET, atau beberapa aspek proyek, seperti meningkatkan file konfigurasi dari jenis yang lebih lama ke jenis yang lebih baru.

Asisten Peningkatan .NET dibangun ke dalam Visual Studio dan dapat diinstal sebagai alat antarmuka baris perintah (CLI).

Penting

Asisten Peningkatan .NET secara resmi tidak digunakan lagi. Gunakan agen obrolan modernisasi GitHub Copilot sebagai gantinya, yang disertakan dengan Visual Studio 2026 dan Visual Studio 2022 17.14.16 atau yang lebih baru. Agen ini menganalisis proyek dan dependensi Anda, menghasilkan rencana migrasi langkah demi langkah dengan rekomendasi yang ditargetkan dan perbaikan kode otomatis, dan menerapkan setiap perubahan sehingga Anda dapat memvalidasi atau mengembalikan. Ini mengotomatiskan tugas porting umum—memperbarui file proyek, mengganti API yang tidak digunakan lagi, dan menyelesaikan masalah build—sehingga Anda dapat memodernisasi lebih cepat dengan lebih sedikit upaya manual.

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
  • Xamarin Forms
  • .NET MAUI
  • .NET Native UWP

Beberapa produk memberikan panduan tentang cara menggunakan Asisten Peningkatan .NET.

Jalur Peningkatan

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
  • Xamarin Forms ke .NET MAUI
    • Transformasi file XAML hanya mendukung peningkatan namespace. Untuk transformasi yang lebih komprehensif, gunakan Visual Studio 2022 atau yang lebih baru.

Detail dan opsi upgrade

Saat pemutakhiran dimulai, wizard membimbing Anda untuk mengonfigurasi beberapa opsi sebelum pemutakhiran dimulai. Berdasarkan jenis proyek yang Anda tingkatkan, wizard menyajikan opsi yang berbeda. Untuk contoh peningkatan proyek, lihat Upgrade proyek dengan .NET Upgrade Assistant.

Bagaimana peningkatan harus dilakukan

Berdasarkan jenis proyek yang Anda tingkatkan, Anda mungkin dapat mengubah cara peningkatan dilakukan. 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 memperbarui salinannya, meninggalkan proyek asli Anda.

  • 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 aplikasi pustaka secara bertahap dan satu per satu.

Hasil Upgrade

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 telah ditingkatkan dan berhasil diselesaikan.
  • Tanda peringatan kuning: Artefak telah ditingkatkan, tetapi ada informasi penting yang harus Anda pertimbangkan.
  • Red X: Peningkatan artefak tidak berhasil.

Tab Hasil Peningkatan .NET Upgrade Assistant di Visual Studio.

Selain itu, tindakan yang dilakukan selama peningkatan dicatatkan ke dalam jendela Output dengan sumber Asisten Peningkatan, seperti yang ditunjukkan pada gambar berikut:

Jendela output di Visual Studio memperlihatkan hasil dari Asisten Peningkatan .NET.

Setelah meningkatkan proyek Anda, uji secara menyeluruh!

Konten terkait

  • Last updated on