Menginstal dan mengelola paket NuGet dengan dotnet CLI

  • Artikel

Anda dapat menggunakan alat CLI dotnet di Windows, macOS, atau Linux untuk menginstal, mencopot, dan memperbarui paket NuGet dengan mudah dalam proyek dan solusi .NET. Artikel ini menjelaskan perintah CLI dotnet yang paling umum untuk mengelola paket NuGet.

Dotnet CLI berjalan pada proyek gaya .NET, .NET Core, .NET Standard SDK, dan proyek gaya SDK lainnya, misalnya proyek yang menargetkan .NET Framework. Untuk informasi selengkapnya, lihat .NET project SDK.

Untuk sebagian besar perintah, alat CLI mencari file proyek di direktori saat ini, kecuali file proyek yang berbeda ditentukan sebagai sakelar opsional dalam perintah. Untuk daftar lengkap perintah dan argumennya, lihat perintah CLI dotnet.

Prasyarat

  • .NET Core SDK, yang menyediakan dotnet alat baris perintah. Mulai visual Studio 2017, CLI dotnet secara otomatis diinstal dengan semua beban kerja terkait .NET dan .NET Core.

Menginstal atau memperbarui paket

Perintah tambahkan paket dotnet menambahkan referensi paket ke file proyek, lalu berjalan dotnet restore untuk menginstal paket.

  1. Buka baris perintah dan beralih ke direktori yang memuat file proyek Anda.

  2. Gunakan perintah berikut untuk menginstal paket NuGet:

    dotnet add package <PACKAGE_NAME>

    Misalnya, untuk menginstal Newtonsoft.Json paket, gunakan perintah berikut

    dotnet add package Newtonsoft.Json

  3. Setelah perintah selesai, Anda dapat membuka file proyek untuk melihat referensi paket.

    Misalnya, buka file .csproj untuk melihat referensi paket yang ditambahkan Newtonsoft.Json :

    <ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
</ItemGroup>

Menginstal versi paket tertentu

Perintah dotnet add package menginstal versi terbaru paket kecuali Anda menentukan versi yang berbeda.

Untuk menginstal versi tertentu dari paket NuGet, gunakan opsional -v atau --version sakelar:

dotnet add package <PACKAGE_NAME> -v <VERSION>

Misalnya, untuk menambahkan paket versi 12.0.1 Newtonsoft.Json , gunakan perintah ini:

dotnet add package Newtonsoft.Json --version 12.0.1

Referensi paket daftar

Cantumkan referensi paket dan versi untuk proyek Anda dengan menggunakan perintah paket daftar dotnet:

dotnet list package

Menghapus paket

Gunakan perintah hapus paket dotnet untuk menghapus referensi paket dari file proyek.

dotnet remove package <PACKAGE_NAME>

Misalnya, untuk menghapus Newtonsoft.Json paket, gunakan perintah berikut:

dotnet remove package Newtonsoft.Json

Memulihkan paket

Perintah pemulihan dotnet memulihkan paket yang dicantumkan file proyek dengan <PackageReference>. Untuk informasi selengkapnya, lihat PackageReference dalam file proyek.

.NET Core 2.0 dan yang lebih baru dotnet build dan dotnet run perintah memulihkan paket secara otomatis. Pada NuGet 4.0, dotnet restore menjalankan kode yang sama dengan nuget restore.

Untuk memulihkan paket dengan dotnet restore:

  1. Buka baris perintah dan beralih ke direktori yang memuat file proyek Anda.
  2. Jalankan dotnet restore.

Langkah berikutnya