Dela via

Hantera NuGet-paket med NuGet CLI

Du kan använda CLI-verktyget nuget.exe för att hantera NuGet-paket i Visual Studio-projekt och -lösningar. I den här artikeln beskrivs de vanligaste NuGet CLI-kommandona för att hantera NuGet-paket. Alla dessa kommandon fungerar i Windows och de flesta fungerar på Mac och Linux med Mono.

NuGet CLI körs på .NET Framework- och icke-SDK-liknande projekt, till exempel projekt i icke-SDK-format som riktar sig till .NET Standard-bibliotek. NuGet CLI-kommandon kan använda ett projekt packages.config fil som visar paketreferenser. För icke-SDK-liknande projekt som använder PackageReference i stället för packages.config för paketreferenser använder du dotnet CLI i stället.

Anmärkning

För de flesta icke-SDK-liknande projekt som använder packages.configär det bäst att migrera packages.config till PackageReference och sedan använda dotnet CLI i stället för NuGet CLI för att hantera paket. Du kan dock inte migrera C++ eller ASP.NET projekt.

För de flesta kommandon använder NuGet CLI-verktyget den aktuella katalogen, såvida du inte anger en annan plats i kommandot. Om du vill köra NuGet CLI-kommandon öppnar du en kommandorad och växlar till katalogen som innehåller projektfilen.

En fullständig lista över kommandon och deras argument finns i NuGet CLI-referensen.

Förutsättningar

Ladda ned NuGet CLI från nuget.org. Spara nuget.exe-filen i en lämplig katalog och kontrollera att katalogen finns i path-miljövariabeln.

Anmärkning

Du kan också använda winget-verktyget för Windows eller Homebrew för macOS.

Om du vill ta reda på din NuGet CLI-version öppnar du en kommandorad och kör nuget help, eller för att undvika att behöva rulla uppåt använder du nuget help | more. Den första raden i hjälputdata visar versionen.

Installera ett paket

NuGet CLI-installationskommandot laddar ned och installerar angivna NuGet-paket.

Viktigt!

Kommandot install ändrar inte projektfilen eller packages.config filen. Kommandona install och restore lägger bara till paket till disken, men lägger inte till beroenden i projekt. Om du vill lägga till projektberoenden lägger du till paket via Visual Studio Package Manager-användargränssnittet eller Package Manager-konsolen och kör install sedan eller restore.

Använd alternativet -OutputDirectory för att installera paket i en specifik katalog. Om du inte anger någon utdatakatalog install använder du den aktuella katalogen.

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

Om du till exempel vill installera Newtonsoft.json paketet i underkatalogen paket använder du följande kommando:

nuget install Newtonsoft.Json -OutputDirectory packages

I stället för att ange ett paket som ska installeras kan du ange en befintlig packages.config fil i den aktuella eller en annan katalog. Kommandot install installerar alla paket som anges i filenpackages.config .

nuget install packages.config

Följande kommando installerar till exempel alla paket som anges i packages.config i underkatalogen config till underkatalogen paket :

nuget install config\packages.config -OutputDirectory packages

Installera en specifik version av ett paket

Kommandot install installerar den senaste versionen av ett paket om du inte anger en annan version. Om du vill installera en specifik version av ett paket använder du alternativet -Version :

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

Om du till exempel vill installera version 12.0.1 av Newtonsoft.json paketet använder du:

nuget install Newtonsoft.Json -Version 12.0.1

Lista paket

Använd listkommandot för att visa en lista över paket som är installerade i paketmapparna. Använd alternativet -Source för att begränsa listan.

nuget list -Source <source>

Om du till exempel vill visa en lista över paket i underkatalogenmyproject använder du:

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

Du kan också använda en sökterm för att söka efter paketnamn, taggar eller beskrivningar:

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

Uppdatera alla paket

Använd uppdateringskommandot för att uppdatera alla paket i ett projekt packages.config fil till de senaste tillgängliga versionerna. Det är bäst att köra restore innan du kör update.

nuget update

Ta bort ett paket

Ta bort ett paket genom att ta bort paketet från projektmappen. För att installera om paketen använder du kommandona restore eller install.

Om du tar bort paket från disken uppdateras inte projektet, packages.configeller NuGet.Config-filerna . Det bästa sättet att ta bort paket är via Visual Studio Package Manager-användargränssnittet eller Package Manager-konsolen.

Återställa paket

NuGet CLI-återställningskommandot laddar ned och installerar eventuella paket som saknas. Kommandot fungerar på projekt som använder antingen PackageReference eller packages.config för paketreferenser.

Precis som installlägger kommandot bara till paket till disken, men ändrar inte projektfilen eller restore. Om du vill lägga till projektberoenden använder du Visual Studio Package Manager-användargränssnittet eller konsolen.

Kör följande kommando för att återställa paket:

nuget restore <projectPath>

Kommandot restore använder en lösningsfil eller en package.config fil i den angivna projektsökvägen.

Om du till exempel vill återställa alla paket för MySolution.sln i den aktuella katalogen kör du:

nuget restore MySolution.sln

Anmärkning

För icke-SDK-liknande projekt som använder PackageReferenceanvänder du msbuild -t:restore för att återställa paket i stället.

Mer information finns i Återställa paket.

Nästa steg