Menginstal dan mengelola paket dengan Package Manager Console di Visual Studio (PowerShell)

  • Artikel
  • 5 menit untuk membaca

Konsol Manajer Paket NuGet memungkinkan Anda menggunakan perintah NuGet PowerShell untuk menemukan, menginstal, menghapus instalasi, dan memperbarui paket NuGet. Menggunakan konsol diperlukan dalam kasus di mana UI Pengelola Paket tidak menyediakan cara untuk melakukan operasi. Untuk menggunakan nuget.exe perintah CLI di konsol, lihat Menggunakan CLI nuget.exe di konsol.

Konsol ini dibangun ke dalam Visual Studio di Windows. Ini tidak disertakan dengan Visual Studio untuk Mac atau Visual Studio Code.

Penting

Perintah yang tercantum di sini khusus untuk Konsol Manajer Paket di Visual Studio, dan berbeda dari perintah modul Manajemen Paket yang tersedia di lingkungan PowerShell umum. Secara khusus, setiap lingkungan memiliki perintah yang tidak tersedia di lingkungan lain, dan perintah dengan nama yang sama mungkin juga berbeda dalam argumen spesifiknya. Saat menggunakan Package Management Console di Visual Studio, perintah dan argumen yang didokumenkan dalam topik ini berlaku.

Menemukan dan menginstal paket

Misalnya, menemukan dan menginstal paket dilakukan dengan tiga langkah mudah:

  1. Buka proyek/solusi di Visual Studio, dan buka konsol menggunakan perintah Tools > NuGet Package Manager > Package Manager Console.

  2. Temukan paket yang ingin Anda instal. Jika Anda sudah tahu ini, lewati ke langkah 3.

    # Find packages containing the keyword "elmah"
Find-Package elmah

  3. Jalankan perintah instal:

    # Install the Elmah package to the project named MyProject.
Install-Package Elmah -ProjectName MyProject

Penting

Semua operasi yang tersedia di konsol juga dapat dilakukan dengan NuGet CLI. Namun, perintah konsol beroperasi dalam konteks Visual Studio dan proyek/solusi yang disimpan dan sering mencapai lebih dari perintah CLI yang setara. Misalnya, menginstal paket melalui konsol menambahkan referensi ke proyek sedangkan perintah CLI tidak. Untuk alasan ini, pengembang yang bekerja di Visual Studio biasanya lebih suka menggunakan konsol ke CLI.

Tip

Banyak operasi konsol bergantung pada solusi yang dibuka di Visual Studio dengan nama jalur yang diketahui. Jika Anda memiliki solusi yang belum disimpan, atau tidak ada solusi, Anda dapat melihat kesalahan, "Solusi tidak dibuka atau tidak disimpan. Pastikan Anda memiliki solusi yang terbuka dan tersimpan." Ini menunjukkan bahwa konsol tidak dapat menentukan folder solusi. Menyimpan solusi yang belum disimpan, atau membuat dan menyimpan solusi jika Anda tidak membukanya, harus memperbaiki kesalahan.

Membuka kontrol konsol dan konsol

  1. Buka konsol di Visual Studio menggunakan perintah Tools > NuGet Package Manager > Package Manager Console. Konsol adalah jendela Visual Studio yang dapat diatur dan diposisikan sesuka Anda (lihat Menyesuaikan tata letak jendela di Visual Studio).

  2. Secara default, perintah konsol beroperasi terhadap sumber paket dan proyek tertentu sebagaimana diatur dalam kontrol di bagian atas jendela:

    Package Manager Console controls for package source and project

  3. Memilih sumber paket dan/atau proyek yang berbeda mengubah default tersebut untuk perintah berikutnya. Untuk menimpa pengaturan ini tanpa mengubah default, sebagian besar perintah mendukung -Source dan -ProjectName opsi.

  4. Untuk mengelola sumber paket, pilih ikon gigi. Ini adalah pintasan ke kotak dialog Opsi > Alat > NuGet Package Manager > Package Sources seperti yang dijelaskan di halaman UI Pengelola Paket. Selain itu, kontrol di sebelah kanan pemilih proyek menghapus konten konsol:

    Package Manager Console settings and clear controls

  5. Tombol paling kanan mengganggu perintah yang berjalan lama. Misalnya, menjalankan Get-Package -ListAvailable -PageSize 500 mencantumkan 500 paket teratas pada sumber default (seperti nuget.org), yang bisa memakan waktu beberapa menit untuk dijalankan.

    Package Manager Console stop control

Memasang paket

# Add the Elmah package to the default project as specified in the console's project selector
Install-Package Elmah

# Add the Elmah package to a project named UtilitiesLib that is not the default
Install-Package Elmah -ProjectName UtilitiesLib

Lihat Install-Package.

Menginstal paket di konsol melakukan langkah yang sama seperti yang dijelaskan pada Apa yang terjadi saat paket diinstal, dengan penambahan berikut:

  • Konsol menampilkan ketentuan lisensi yang berlaku di jendelanya dengan perjanjian tersirat. Jika Anda tidak menyetujui persyaratan, Anda harus segera menghapus instalan paket.
  • Referensi juga ke paket ditambahkan ke file proyek dan muncul di Penjelajah Solusi di bawah simpul Referensi, Anda perlu menyimpan proyek untuk melihat perubahan dalam file proyek secara langsung.

Menghapus instalan paket

# Uninstalls the Elmah package from the default project
Uninstall-Package Elmah

# Uninstalls the Elmah package and all its unused dependencies
Uninstall-Package Elmah -RemoveDependencies 

# Uninstalls the Elmah package even if another package depends on it
Uninstall-Package Elmah -Force

Lihat Hapus Instalan-Paket. Gunakan Get-Package untuk melihat semua paket yang saat ini diinstal dalam proyek default jika Anda perlu menemukan pengidentifikasi.

Menghapus instalasi paket melakukan tindakan berikut:

  • Menghapus referensi ke paket dari proyek (dan format manajemen apa pun yang digunakan). Referensi tidak lagi muncul di Penjelajah Solusi. (Anda mungkin perlu membangun kembali proyek untuk melihatnya dihapus dari folder Bin .)
  • Membalikkan perubahan apa pun yang dilakukan pada app.config atau web.config ketika paket diinstal.
  • Menghapus dependensi yang diinstal sebelumnya jika tidak ada paket yang tersisa yang menggunakan dependensi tersebut.

Memperbarui paket

# Checks if there are newer versions available for any installed packages
Get-Package -updates

# Updates a specific package using its identifier, in this case jQuery
Update-Package jQuery

# Update all packages in the project named MyProject (as it appears in Solution Explorer)
Update-Package -ProjectName MyProject

# Update all packages in the solution
Update-Package

Lihat Get-Package dan Update-Package

Menemukan paket

# Find packages containing keywords
Find-Package elmah
Find-Package logging

# List packages whose ID begins with Elmah
Find-Package Elmah -StartWith

# By default, Get-Package returns a list of 20 packages; use -First to show more
Find-Package logging -First 100

# List all versions of the package with the ID of "jquery"
Find-Package jquery -AllVersions -ExactMatch

Lihat Temukan Paket. Pada Visual Studio 2013 dan yang lebih lama, gunakan Get-Package sebagai gantinya.

Ketersediaan konsol

Mulai Visual Studio 2017, NuGet dan NuGet Package Manager secara otomatis diinstal saat Anda memilih apa pun. Beban kerja terkait NET; Anda juga dapat menginstalnya satu per satu dengan memeriksa opsi Pengelola paket NuGet alat > Kode komponen individual di alat penginstal > Visual Studio.

Selain itu, jika Anda kehilangan Manajer Paket NuGet di Visual Studio 2015 dan yang lebih lama, periksa Ekstensi dan Pembaruan Alat>... dan cari ekstensi NuGet Package Manager. Jika Anda tidak dapat menggunakan alat penginstal ekstensi di Visual Studio, Anda dapat mengunduh ekstensi langsung dari https://dist.nuget.org/index.html.

Konsol Manajer Paket saat ini tidak tersedia dengan Visual Studio untuk Mac. Namun, perintah yang setara tersedia melalui NuGet CLI. Visual Studio untuk Mac memang memiliki UI untuk mengelola paket NuGet. Lihat Menyertakan paket NuGet dalam proyek Anda.

Konsol Pengelola Paket tidak disertakan dengan Visual Studio Code.

Memperluas Konsol Manajer Paket

Beberapa paket menginstal perintah baru untuk konsol. Misalnya, MvcScaffolding membuat perintah seperti Scaffold yang ditunjukkan di bawah ini, yang menghasilkan pengontrol dan tampilan MVC ASP.NET:

Installing and using MvcScaffold

Menyiapkan profil NuGet PowerShell

Profil PowerShell memungkinkan Anda membuat perintah yang umum digunakan tersedia di mana pun Anda menggunakan PowerShell. NuGet mendukung profil khusus NuGet biasanya ditemukan di lokasi berikut:

%UserProfile%\Documents\WindowsPowerShell\NuGet_profile.ps1

Untuk menemukan profil, ketik $profile di konsol:

$profile
C:\Users\<user>\Documents\WindowsPowerShell\NuGet_profile.ps1

Untuk detail selengkapnya, lihat Profil Windows PowerShell.

Menggunakan CLI nuget.exe di konsol

Untuk membuat nuget.exe CLI tersedia di Package Manager Console, instal paket NuGet.CommandLine dari konsol:

# Other versions are available, see https://www.nuget.org/packages/NuGet.CommandLine/
Install-Package NuGet.CommandLine -Version 4.4.1