Dela via

Installera och hantera NuGet-paket med dotnet CLI

Du kan använda dotnet CLI-verktyget i Windows, macOS eller Linux för att enkelt installera, avinstallera och uppdatera NuGet-paket i .NET-projekt och -lösningar. I den här artikeln beskrivs de vanligaste CLI-kommandona för dotnet för att hantera NuGet-paket.

Dotnet CLI körs på .NET-, .NET Core-, .NET Standard SDK-liknande projekt och andra SDK-liknande projekt, till exempel sådana som är avsedda för .NET Framework. Mer information finns i .NET-projekt-SDK:er.

För de flesta kommandon söker CLI-verktyget efter en projektfil i den aktuella katalogen, såvida inte en annan projektfil anges som en valfri växel i kommandot. En fullständig lista över kommandon och deras argument finns i dotnet CLI-kommandon.

Förutsättningar

  • .NET Core SDK, som tillhandahåller dotnet kommandoradsverktyget. Från och med Visual Studio 2017 installeras dotnet CLI automatiskt med alla .NET- och .NET Core-relaterade arbetsbelastningar.

Installera eller uppdatera ett paket

Kommandot dotnet add package lägger till en paketreferens till projektfilen och kör dotnet restore sedan för att installera paketet.

  1. Öppna en kommandorad och växla till katalogen som innehåller projektfilen.

  2. Använd följande kommando för att installera ett NuGet-paket:

    dotnet add package <PACKAGE_NAME>

    Om du till exempel vill installera Newtonsoft.Json paketet använder du följande kommando

    dotnet add package Newtonsoft.Json

  3. När kommandot har slutförts kan du öppna projektfilen för att se paketreferensen.

    Öppna till exempel .csproj-filen för att se den tillagda Newtonsoft.Json paketreferensen:

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

Installera en specifik version av ett paket

Kommandot dotnet add package installerar den senaste versionen av paketet om du inte anger en annan version.

För att installera en specifik version av ett NuGet-paket, använd den valfria -v eller --version växeln:

dotnet add package <PACKAGE_NAME> -v <VERSION>

Om du till exempel vill lägga till version 12.0.1 av Newtonsoft.Json paketet använder du följande kommando:

dotnet add package Newtonsoft.Json --version 12.0.1

Lista paketreferenser

Visa en lista över paketreferenser och versioner för projektet med hjälp av kommandot dotnet list package :

dotnet list package

Ta bort ett paket

Använd kommandot dotnet remove package för att ta bort en paketreferens från projektfilen.

dotnet remove package <PACKAGE_NAME>

Om du till exempel vill ta bort Newtonsoft.Json paketet använder du följande kommando:

dotnet remove package Newtonsoft.Json

Återställa paket

Kommandot dotnet restore återställer paket som projektfilen visar med <PackageReference>. Mer information finns i PackageReference i projektfiler.

.NET Core 2.0 och senare dotnet build och dotnet run kommandon återställer paket automatiskt. Från och med NuGet 4.0 dotnet restore kör samma kod som nuget restore.

Så här återställer du ett paket med dotnet restore:

  1. Öppna en kommandorad och växla till katalogen som innehåller projektfilen.
  2. Kör dotnet restore.

Nästa steg