Mengelola paket NuGet dengan NuGet CLI

  • Artikel

Anda dapat menggunakan nuget.exe alat CLI untuk mengelola paket NuGet dalam proyek dan solusi Visual Studio. Artikel ini menjelaskan perintah NuGet CLI yang paling umum untuk mengelola paket NuGet. Semua perintah ini berfungsi di Windows, dan sebagian besar bekerja di Mac dan di Linux dengan Mono.

NuGet CLI berjalan pada proyek .NET Framework dan non-SDK-style, misalnya proyek gaya non-SDK yang menargetkan pustaka .NET Standard. Perintah NuGet CLI dapat menggunakan file packages.config proyek yang mencantumkan referensi paket. Untuk proyek gaya non-SDK yang menggunakan PackageReference alih-alih packages.config untuk referensi paket, gunakan CLI dotnet sebagai gantinya.

Catatan

Untuk sebagian besar proyek gaya non-SDK yang menggunakan packages.config, yang terbaik adalah memigrasikan packages.config ke PackageReference, lalu menggunakan dotnet CLI alih-alih NuGet CLI untuk mengelola paket. Namun, Anda tidak dapat memigrasikan proyek C++ atau ASP.NET.

Untuk sebagian besar perintah, alat NuGet CLI menggunakan direktori saat ini, kecuali Anda menentukan lokasi yang berbeda dalam perintah. Untuk menjalankan perintah NuGet CLI, buka baris perintah dan beralih ke direktori yang berisi file proyek Anda.

Untuk daftar lengkap perintah dan argumennya, lihat referensi NuGet CLI.

Prasyarat

Unduh NuGet CLI dari nuget.org. Simpan file nuget.exe ke direktori yang sesuai, dan pastikan direktori berada dalam variabel lingkungan PATH Anda.

Catatan

Anda juga dapat menggunakan alat winget untuk Windows atau Homebrew untuk macOS.

Untuk mengetahui versi NuGet CLI Anda, buka baris perintah dan jalankan nuget help, atau untuk menghindari harus menggulir ke atas, gunakan nuget help | more. Baris pertama dalam output bantuan menunjukkan versi.

Menginstal paket

Perintah penginstalan NuGet CLI mengunduh dan menginstal paket NuGet tertentu.

Penting

Perintah install tidak mengubah file proyek atau file packages.config . install Perintah dan restore hanya menambahkan paket ke disk, tetapi tidak menambahkan dependensi ke proyek. Untuk menambahkan dependensi proyek, tambahkan paket melalui UI Manajer Paket Visual Studio atau Konsol Manajer Paket, lalu jalankan install atau restore.

-OutputDirectory Gunakan opsi untuk menginstal paket ke direktori tertentu. Jika Anda tidak menentukan direktori output, install gunakan direktori saat ini.

nuget install <packageID | configFilePath> -OutputDirectory <outputDirectory>

Misalnya, untuk menginstal Newtonsoft.json paket ke subdirektori paket , gunakan perintah berikut:

nuget install Newtonsoft.Json -OutputDirectory packages

Alih-alih menentukan paket yang akan diinstal, Anda dapat menentukan file packages.config yang ada di direktori saat ini atau yang lain. Perintah install menginstal semua paket yang tercantum dalam file packages.config .

nuget install packages.config

Misalnya, perintah berikut menginstal semua paket yang tercantum dalam packages.config di subdirektori konfigurasi ke subdirektori paket:

nuget install config\packages.config -OutputDirectory packages

Menginstal versi paket tertentu

Perintah install menginstal versi terbaru paket kecuali Anda menentukan versi yang berbeda. Untuk menginstal versi paket tertentu, gunakan -Version opsi :

nuget install <packageID | configFilePath> -Version <version>

Misalnya, untuk menginstal paket versi 12.0.1 Newtonsoft.json , gunakan:

nuget install Newtonsoft.Json -Version 12.0.1

Mencantumkan paket

Gunakan perintah daftar untuk menampilkan daftar paket yang diinstal dalam folder paket. -Source Gunakan opsi untuk membatasi daftar.

nuget list -Source <source>

Misalnya, untuk mencantumkan paket dalam subdirektori paket MyProject, gunakan:

nuget list -Source C:\Users\%USERNAME%\source\repos\MyProject\packages

Anda juga dapat menggunakan istilah pencarian untuk mencari nama paket, tag, atau deskripsi:

nuget list <"search term"> -Source <source>

Memperbarui semua paket

Gunakan perintah pembaruan untuk memperbarui semua paket dalam file project packages.config ke versi terbaru yang tersedia. Yang terbaik adalah menjalankan restore sebelum Anda menjalankan update.

nuget update

Menghapus paket

Untuk menghapus paket, hapus paket tersebut dari folder proyek. Untuk menginstal ulang paket, gunakan restore perintah atau install .

Menghapus paket dari disk tidak memperbarui file project, packages.config, atau NuGet.Config . Cara terbaik untuk menghapus paket adalah melalui UI Manajer Paket Visual Studio atau Konsol Manajer Paket.

Memulihkan paket

Perintah pemulihan NuGet CLI mengunduh dan menginstal paket yang hilang. Perintah ini berfungsi pada proyek yang menggunakan PackageReference atau packages.config untuk referensi paket.

Seperti install, restore perintah hanya menambahkan paket ke disk, tetapi tidak mengubah file proyek atau packages.config. Untuk menambahkan dependensi proyek, gunakan UI atau Konsol Manajer Paket Visual Studio.

Untuk memulihkan paket, jalankan perintah berikut:

nuget restore <projectPath>

Perintah restore menggunakan file solusi atau file package.config di jalur proyek yang ditentukan.

Misalnya, untuk memulihkan semua paket untuk MySolution.sln di direktori saat ini, jalankan:

nuget restore MySolution.sln

Catatan

Untuk proyek gaya non-SDK yang menggunakan PackageReference, gunakan msbuild -t:restore untuk memulihkan paket sebagai gantinya.

Untuk informasi selengkapnya, lihat Memulihkan paket.

Langkah berikutnya