Bagikan melalui

Menginstal dan mengelola paket di Visual Studio menggunakan NuGet Package Manager

UI Pengelola Paket NuGet di Microsoft Visual Studio untuk Windows memungkinkan Anda menginstal, menghapus, dan memperbarui paket NuGet dengan mudah dalam proyek dan solusi.

Artikel ini hanya untuk pengguna Windows. Jika Anda menggunakan Visual Studio untuk Mac, lihat Menyertakan paket NuGet di proyek Anda.

Prasyarat

  • Instal Visual Studio 2022 untuk Windows dengan beban kerja terkait .NET apa pun.

    Anda dapat menginstal edisi Komunitas 2022 secara gratis dari visualstudio.microsoft.com, atau menggunakan edisi Profesional atau Perusahaan.

    Visual Studio 2017 dan yang lebih tinggi secara otomatis menyertakan NuGet Package Manager saat workload berbasis .NET diinstal. Untuk menginstalnya secara individual di Penginstal Visual Studio, pilih tab komponen Individual, lalu pilih manajer paket NuGet di bawah Kode alat .

    Untuk Visual Studio 2015, jika Anda kehilangan Pengelola Paket NuGet, periksa Alat Ekstensi dan Pembaruan> dan cari ekstensi Pengelola Paket NuGet . Jika Anda tidak dapat menggunakan alat penginstal ekstensi di Visual Studio, unduh ekstensi langsung dari https://dist.nuget.org/index.html.

  • Daftar untuk akun gratis di nuget.org jika Anda belum memilikinya. Anda harus mendaftar dan mengonfirmasi akun sebelum dapat mengunggah paket NuGet.

Menemukan dan menginstal paket

Untuk menemukan dan menginstal paket NuGet dengan Visual Studio, ikuti langkah-langkah berikut:

  1. Muat proyek di Penjelajah Solusi, lalu pilih Project>Kelola Paket NuGet.

    Jendela Manajer Paket NuGet terbuka.

  2. Pilih tab Telusuri untuk menampilkan paket berdasarkan popularitas dari sumber yang saat ini dipilih (lihat sumber Paket ).

    • Untuk mencari paket tertentu, gunakan kotak pencarian di kiri atas.
    • Informasi singkatan dapat ditampilkan di samping setiap ID paket untuk membantu mengidentifikasi paket yang benar, dan bervariasi berdasarkan sumber paket yang dipilih. Contohnya termasuk jumlah unduhan paket, penulis, atau hyperlink profil pemilik.

    Nota

    Di Visual Studio 17.11 dan versi lebih tinggi, pemilik paket ditampilkan sebagai hyperlink profil jika didukung oleh sumber paket yang dipilih. Kepemilikan paket ditentukan oleh sumber paket. Misalnya, lihat Mengelola pemilik paket di nuget.org.

    Di Visual Studio 17.10 dan versi yang lebih lama, metadata penulis paket ditampilkan dalam format teks biasa. Untuk informasi selengkapnya, lihat metadata paket penulis .

    • Pilih paket untuk melihat informasi paket terperinci. Panel detail di sebelah kanan muncul dan memungkinkan Anda memilih versi yang akan diinstal. Cuplikan layar memperlihatkan jendela Pengelola Paket NuGet dengan tab Telusuri, panel detail, dan tab Anda dapat melihat metadata paket, informasi tentang pemilik, penulis, lisensi, dll., di tab Detail Paket dan file README paket (jika disediakan oleh pembuat paket) di tab README. Cuplikan layar memperlihatkan jendela Manajer Paket NuGet dengan tab README dipilih.

  3. Di panel kanan, pilih Versi dari daftar turun bawah. Jika Anda ingin menyertakan versi prarilis dalam daftar versi , pilih Sertakan prarilis.

  4. Untuk menginstal paket NuGet, pilih Instal. Anda mungkin diminta untuk menerima persyaratan lisensi atau diminta untuk memverifikasi penginstalan.

    Visual Studio menginstal paket dan dependensinya dalam proyek. Setelah penginstalan selesai, paket yang ditambahkan muncul di tab Terinstal. Anda juga dapat menemukan paket di simpul Dependensi>Paket di proyek Anda di Penjelajah Solusi. Setelah menginstal paket, Anda dapat merujuknya dalam proyek dengan pernyataan using.

  5. (Opsional) NuGet memiliki dua format di mana proyek dapat menggunakan paket: PackageReference dan packages.config. Untuk mengatur format default, pilih Tools>Options, perluas NuGet Package Manager, pilih General, lalu pilih format manajemen paket default . Untuk informasi selengkapnya, lihat Memilih format manajemen paket default.

Copot pemasangan paket

Untuk menghapus instalan paket NuGet, ikuti langkah-langkah berikut:

  1. Muat proyek di Penjelajah Solusi , pilih Project>Kelola Paket NuGet, lalu pilih tab Terinstal.

  2. Pilih paket untuk menghapus instalasi di panel kiri (gunakan kotak Pencarian untuk menemukannya, jika perlu), lalu pilih Hapus instalan dari panel kanan.

    Cuplikan layar memperlihatkan Pengelola Paket NuGet dengan paket dipilih dan tombol Hapus Instalannya disorot.

Memperbarui paket

Untuk memperbarui paket NuGet, ikuti langkah-langkah berikut:

  1. Muat proyek di Penjelajah Solusi, lalu pilih Project>Kelola Paket NuGet. Untuk proyek situs web, pilih folder Bin terlebih dahulu.

  2. Pilih tab Pembaruan untuk melihat paket yang memiliki pembaruan yang tersedia dari sumber Paket yang dipilih. Pilih Sertakan prarilis untuk memasukkan paket prarilis dalam daftar pembaruan.

  3. Pilih paket yang akan diperbarui. Di panel kanan, pilih versi yang diinginkan dari menu dropdown, lalu pilih Perbarui.

    Cuplikan layar memperlihatkan Manajer Paket NuGet dengan paket dipilih dan tombol Perbarui disorot.

  4. Untuk beberapa paket, tombol Pembaruan dinonaktifkan dan pesan berikut muncul: Dirujuk secara implisit oleh SDK. Untuk memperbarui paket, perbarui SDK tempat paket berada. Pesan ini menunjukkan bahwa paket adalah bagian dari kerangka kerja atau SDK yang lebih besar dan tidak dapat diperbarui secara independen. Paket tersebut ditandai secara internal dengan <IsImplicitlyDefined>True</IsImplicitlyDefined>. Misalnya, Microsoft.NETCore.App adalah bagian dari .NET Core SDK, dan versi paketnya berbeda dari versi kerangka kerja runtime yang digunakan oleh aplikasi. Untuk mengunduh versi baru .NET Core, perbarui penginstalan .NET Core Anda. Untuk informasi selengkapnya, lihat metapaket .NET Core dan pengaturan versi. Skenario ini berlaku untuk paket yang umum digunakan berikut:

    • Microsoft.AspNetCore.All
    • Microsoft.AspNetCore.App
    • Microsoft.NETCore.App
    • NETStandard.Library

    Cuplikan layar memperlihatkan paket NuGet dengan tombol Perbarui dinonaktifkan.

  5. Untuk memperbarui beberapa paket ke versi terbarunya, pilih di daftar paket NuGet, lalu pilih Perbarui.

  6. Anda juga dapat memperbarui paket individual dari tab Terinstal . Untuk kasus ini, Anda juga dapat memilih Versi dan opsi Sertakan prarilis .

Mengelola paket untuk solusi

Mengelola paket untuk solusi adalah cara yang nyaman untuk bekerja dengan beberapa proyek secara bersamaan:

  1. Pilih solusi di Solution Manager, lalu pilih Tools>NuGet Package Manager>Mengelola Paket NuGet untuk Solusi.

  2. Di jendela Kelola Paket NuGet untuk Solusi, pilih proyek yang terpengaruh oleh operasi.

    Cuplikan layar memperlihatkan jendela Kelola Paket untuk Solusi dengan beberapa proyek dipilih.

Tab Konsolidasi

Pengembang biasanya menganggapnya praktik buruk untuk menggunakan versi yang berbeda dari paket NuGet yang sama di berbagai proyek dalam solusi yang sama. Visual Studio memungkinkan Anda menggunakan versi umum untuk paket NuGet Anda. Untuk melakukannya, gunakan tab Konsolidasikan dari jendela Pengelola Paket NuGet untuk menemukan di mana paket dengan nomor versi yang berbeda digunakan oleh proyek yang berbeda dalam solusi.

Cuplikan layar memperlihatkan jendela Kelola Paket untuk Solusi dengan tab Konsolidasikan dipilih.

Dalam contoh ini, proyek ClassLibrary1 menggunakan EntityFramework 6.2.0, sedangkan ConsoleApp1 menggunakan EntityFramework 6.1.0. Untuk mengonsolidasikan versi paket, ikuti langkah-langkah berikut:

  1. Dari tab Konsolidasikan, pilih proyek yang akan diperbarui dalam daftar proyek.

  2. Pilih versi yang akan digunakan untuk semua proyek ini dalam daftar Versi.

  3. Pilih Instal.

    Pengelola Paket NuGet menginstal versi paket yang dipilih ke semua proyek yang dipilih, setelah itu paket tidak lagi muncul pada tab Konsolidasikan.

Sumber paket

Visual Studio mengabaikan urutan sumber paket, dan menggunakan paket dari sumber mana pun yang pertama merespons permintaan. Untuk informasi lebih lanjut, lihat Memulihkan paket. Untuk informasi tentang cara memuat paket dari sumber tertentu, lihat Pemetaan sumber paket .

Untuk mengelola sumber paket NuGet, ikuti langkah-langkah berikut:

  1. Untuk mengubah sumber dari mana Visual Studio memuat metadata paket, pilih sumber dari pemilih sumber Paket .

    Cuplikan layar memperlihatkan pemilih Sumber paket disorot.

  2. Untuk mengelola sumber paket Anda, pilih ikon Pengaturan atau pilih Alat>Opsi.

    Cuplikan layar memperlihatkan ikon Pengaturan sumber paket disorot.

  3. Di jendela Opsi, perluas simpul Manajer Paket NuGet dan pilih Sumber Paket .

    Cuplikan layar memperlihatkan jendela Opsi dengan Sumber Paket dipilih.

  4. Untuk menambahkan sumber, pilih +, edit Nama, masukkan URL atau jalur di Sumber, lalu pilih Perbarui.

    Sumber sekarang muncul dalam daftar turun-an sumber Paket .

  5. Untuk mengubah sumber paket, pilih, lakukan pengeditan dalam kotak Nama dan Sumber, dan pilih Perbarui.

  6. Untuk menonaktifkan sumber paket, kosongkan kotak di sebelah kiri nama dalam daftar.

  7. Untuk menghapus sumber paket, pilih terlebih dahulu sumbernya, kemudian klik tombol X.

    Jika sumber paket muncul kembali setelah Anda menghapusnya, sumber paket mungkin tercantum dalam file NuGet.config tingkat komputer atau tingkat pengguna. Untuk lokasi file-file ini, lihat konfigurasi NuGet umum . Hapus sumber paket dalam file dengan mengeditnya secara manual atau menggunakan perintah nuget sources .

Opsi Kontrol Pengelola Paket NuGet

Saat Anda memilih paket, Pengelola Paket NuGet menampilkan kontrol Opsi yang dapat diperluas di bawah pemilih Versi. Untuk sebagian besar jenis proyek, hanya opsi Tampilkan jendela pratinjau yang disediakan.

Cuplikan layar memperlihatkan kontrol Opsi manajer Paket NuGet diperluas.

Bagian berikut menjelaskan opsi yang tersedia.

Opsi penginstalan dan pembaruan

Opsi ini hanya tersedia untuk jenis proyek tertentu:

  • Perilaku Ketergantungan: Opsi ini mengonfigurasi bagaimana NuGet memutuskan versi paket ketergantungan yang akan diinstal. Ini memiliki pengaturan berikut:

    • Abaikan dependensi melewatkan penginstalan dependensi, yang biasanya menyebabkan kerusakan pada paket yang diinstal.
    • Lowest [Default] menginstal dependensi dengan nomor versi minimal yang memenuhi persyaratan paket utama yang dipilih.
    • Patch Tertinggi menginstal versi dengan nomor versi utama dan minor yang sama, tetapi nomor patch tertinggi. Misalnya, jika versi 1.2.2 ditentukan, versi tertinggi yang dimulai dengan 1.2 akan diinstal
    • Highest Minor memasang versi dengan nomor versi utama yang sama tetapi dengan angka minor dan nomor patch tertinggi. Jika versi 1.2.2 ditentukan, maka versi tertinggi yang dimulai dengan 1 akan diinstal
    • Highest menginstal versi tertinggi yang tersedia dari paket.

  • Tindakan konflik file: Opsi ini menentukan bagaimana NuGet harus menangani paket yang sudah ada di proyek atau komputer lokal. Ini memiliki pengaturan berikut:

    • Prompt memberi perintah kepada NuGet untuk bertanya apakah akan menyimpan atau menimpa paket yang sudah ada.
    • Abaikan Semua menginstruksikan NuGet untuk melewati penimpaan paket yang ada.
    • Menimpa Semua menginstruksikan NuGet untuk menimpa paket yang ada.

Opsi hapus instalan

Opsi ini hanya tersedia untuk jenis proyek tertentu:

  • Menghapus dependensi: Saat dipilih, menghapus paket dependen apa pun jika tidak direferensikan di tempat lain dalam proyek.

  • Hapus instalan paksa meskipun ada dependensi di dalamnya: Saat dipilih, hapus instalan paket meskipun masih dirujuk dalam proyek. Opsi ini biasanya digunakan dalam kombinasi dengan Menghapus dependensi untuk menghapus paket dan dependensi apa pun yang diinstalnya. Namun, menggunakan opsi ini dapat menyebabkan referensi rusak dalam proyek. Dalam kasus seperti itu, Anda mungkin perlu menginstal ulang paket lain tersebut.

  • Temukan video NuGet di Channel 9 dan YouTube.

Lihat juga

Untuk informasi selengkapnya tentang NuGet, lihat artikel berikut ini: