Menginstal Asisten Peningkatan .NET

Artikel ini mengajarkan Anda cara menginstal Asisten Peningkatan .NET menggunakan ekstensi Visual Studio atau alat antarmuka baris perintah (CLI).

Prasyarat

• Sistem Operasi Windows
• Visual Studio 2022 versi 17.1 atau yang lebih baru.
• .NET SDK 8 atau yang lebih baru.

Metode

Asisten Peningkatan .NET dapat diinstal sebagai ekstensi Visual Studio atau sebagai Alat Global .NET.

Ekstensi Visual Studio berjalan di dalam Visual Studio, pada solusi atau proyek yang telah Anda buka. Alat Global .NET adalah aplikasi konsol interaktif yang berjalan pada solusi atau file proyek di atau di bawah direktori saat ini.

Jika Anda menginginkan pengalaman yang disederhanakan untuk membuka proyek di Visual Studio dan meningkatkannya, instal ekstensi.

Ekstensi Visual Studio

Langkah-langkah berikut menginstal ekstensi Visual Studio.

1. Buka Visual Studio.

   Jika jendela Buka Terbaru \ Memulai terbuka, pilih tautan Lanjutkan tanpa kode .

2. Pilih menu Ekstensi>Kelola Ekstensi untuk membuka jendela Pengelola Ekstensi.

3. Pilih tab Telusuri.

4. Ketik asisten peningkatan .NET ke dalam kotak pencarian.

5. Pilih item Asisten Peningkatan .NET, lalu pilih Instal.

   

6. Setelah ekstensi selesai diunduh, tutup Visual Studio untuk memulai penginstalan secara otomatis.

   

7. Pilih Ubah dan ikuti instruksi untuk menginstal ekstensi.

Alat Global .NET

Langkah-langkah berikut menginstal Asisten Peningkatan .NET sebagai Alat Global .NET. Asisten Peningkatan .NET didistribusikan dalam paket NuGet asisten peningkatan.

1. Buka prompt perintah yang memiliki dotnet perintah di Jalur.

2. Jalankan perintah berikut untuk menginstal alat:

   dotnet tool install -g upgrade-assistant
   

   Penting

   Menginstal alat ini mungkin gagal jika Anda telah mengonfigurasi sumber umpan NuGet lainnya. Gunakan parameter untuk memperlakukan kegagalan tersebut --ignore-failed-sources sebagai peringatan alih-alih kesalahan, melewati sumber umpan NuGet lainnya:

   dotnet tool install -g --ignore-failed-sources upgrade-assistant
   

Validasi

Informasi berikut membantu Anda menentukan bahwa Asisten Peningkatan .NET diinstal.

• Ekstensi Visual Studio

  Ada dua cara untuk menentukan apakah Asisten Peningkatan .NET diinstal sebagai ekstensi Visual Studio. Cara tercepat adalah dengan mengklik kanan proyek .NET atau .NET Framework apa pun di jendela Penjelajah Solusi dan memeriksa item menu Peningkatan.

  Cara lain adalah memilih menu Ekstensi>Kelola Ekstensi untuk membuka jendela Pengelola Ekstensi. Kemudian, pilih tab Terinstal dan temukan di daftar ekstensi yang diinstal.

• Alat Global .NET

  Buka prompt perintah dan jalankan upgrade-assistant perintah . Jika respons perintah menunjukkan bahwa perintah tidak diketahui, alat tidak diinstal dengan benar atau tidak ada di PATH.

Pemecahan masalah - Alat Global .NET

Jika Anda mengonfigurasi sumber umpan NuGet tambahan, penginstalan mungkin gagal dengan kesalahan yang menunjukkan bahwa paket NuGet tidak tersedia di umpan. Gunakan parameter untuk memperlakukan kegagalan tersebut --ignore-failed-sources sebagai peringatan alih-alih kesalahan, melewati sumber umpan NuGet lainnya:

dotnet tool install -g --ignore-failed-sources upgrade-assistant