Delen via

NuGet-pakketten beheren met de NuGet CLI

U kunt het nuget.exe CLI-hulpprogramma gebruiken om NuGet-pakketten te beheren in Visual Studio-projecten en -oplossingen. In dit artikel worden de meest voorkomende NuGet CLI-opdrachten beschreven voor het beheren van NuGet-pakketten. Al deze opdrachten werken in Windows, en de meeste werken op Mac en op Linux met Mono.

De NuGet CLI wordt uitgevoerd op .NET Framework- en niet-SDK-projecten, bijvoorbeeld niet-SDK-stijlprojecten die gericht zijn op .NET Standard-bibliotheken. De NuGet CLI-opdrachten kunnen een project packages.config-bestand gebruiken waarin pakketverwijzingen worden vermeld. Gebruik voor projecten die geen SDK-stijl gebruiken en voor pakketverwijzingen in plaats van packages.config, de dotnet CLI.

Opmerking

Voor de meeste niet-SDK-projecten die gebruikmaken vanpackages.config, kunt u het beste packages.config migreren naar PackageReference en vervolgens de dotnet CLI gebruiken in plaats van de NuGet CLI om pakketten te beheren. U kunt echter geen C++ of ASP.NET projecten migreren.

Voor de meeste opdrachten gebruikt het NuGet CLI-hulpprogramma de huidige map, tenzij u een andere locatie in de opdracht opgeeft. Als u NuGet CLI-opdrachten wilt uitvoeren, opent u een opdrachtregel en schakelt u over naar de map die het projectbestand bevat.

Zie de NuGet CLI-verwijzing voor een volledige lijst met opdrachten en hun argumenten.

Vereiste voorwaarden

Download de NuGet CLI van nuget.org. Sla het nuget.exe-bestand op in een geschikte map en zorg ervoor dat de map zich in de omgevingsvariabele PATH bevindt.

Opmerking

U kunt ook het winget-hulpprogramma voor Windows of Homebrew voor macOS gebruiken.

Als u de versie van NuGet CLI wilt achterhalen, opent u een opdrachtregel en voert u nuget help uit, of om te voorkomen dat u omhoog moet scrollen, gebruikt u nuget help | more. Op de eerste regel van de help-uitvoer ziet u de versie.

Een pakket installeren

De NuGet CLI-installatieopdracht downloadt en installeert opgegeven NuGet-pakketten.

Belangrijk

Met de install opdracht wordt het projectbestand of packages.config bestand niet gewijzigd. De install en restore opdrachten voegen alleen pakketten toe aan de schijf, maar voegen geen afhankelijkheden toe aan projecten. Als u projectafhankelijkheden wilt toevoegen, voegt u pakketten toe via de Visual Studio Package Manager-gebruikersinterface of Package Manager-console en voert u deze uit install of restore.

Gebruik de -OutputDirectory optie om pakketten te installeren in een specifieke map. Als u geen uitvoermap opgeeft, install gebruikt u de huidige map.

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

Als u het Newtonsoft.json pakket bijvoorbeeld wilt installeren in de submap pakketten , gebruikt u de volgende opdracht:

nuget install Newtonsoft.Json -OutputDirectory packages

In plaats van een pakket op te geven dat moet worden geïnstalleerd, kunt u een bestaand packages.config-bestand opgeven in de huidige of een andere map. Met install de opdracht worden alle pakketten geïnstalleerd die worden vermeld in het packages.config-bestand .

nuget install packages.config

Met de volgende opdracht worden bijvoorbeeld alle pakketten geïnstalleerd die worden vermeld in packages.config in de submap configuratie in de submap pakketten :

nuget install config\packages.config -OutputDirectory packages

Een specifieke versie van een pakket installeren

Met install de opdracht wordt de nieuwste versie van een pakket geïnstalleerd, tenzij u een andere versie opgeeft. Als u een specifieke versie van een pakket wilt installeren, gebruikt u de -Version volgende optie:

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

Als u bijvoorbeeld versie 12.0.1 van het Newtonsoft.json pakket wilt installeren, gebruikt u:

nuget install Newtonsoft.Json -Version 12.0.1

Pakketten weergeven

Gebruik de lijstopdracht om een lijst weer te geven met pakketten die zijn geïnstalleerd in de mappen met pakketten. Gebruik de -Source optie om de lijst te beperken.

nuget list -Source <source>

Als u bijvoorbeeld pakketten in de submap pakketten van MyProject wilt weergeven, gebruikt u:

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

U kunt ook een zoekterm gebruiken om te zoeken naar pakketnamen, tags of beschrijvingen:

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

Alle pakketten bijwerken

Gebruik de opdracht Bijwerken om alle pakketten in een project packages.config bestand bij te werken naar de meest recente beschikbare versies. Het is raadzaam om restore uit te voeren voordat u update uitvoert.

nuget update

Een pakket verwijderen

Als u een pakket wilt verwijderen, verwijdert u dat pakket uit de projectmap. Als u pakketten opnieuw wilt installeren, gebruikt u de restore of install opdrachten.

Als u pakketten van schijf verwijdert, worden het project, packages.configof NuGet.Config-bestanden niet bijgewerkt. De beste manier om pakketten te verwijderen, is via de Visual Studio Package Manager-gebruikersinterface of Package Manager-console.

Pakketten herstellen

Met de NuGet CLI-herstelopdracht worden ontbrekende pakketten gedownload en geïnstalleerd. De opdracht werkt op projecten die gebruikmaken van PackageReference of packages.config voor pakketverwijzingen.

Net zoals install, de restore opdracht voegt alleen pakketten toe aan schijf, maar wijzigt het projectbestand of packages.configniet. Als u projectafhankelijkheden wilt toevoegen, gebruikt u de gebruikersinterface of console van Visual Studio Package Manager.

Voer de volgende opdracht uit om pakketten te herstellen:

nuget restore <projectPath>

De restore opdracht maakt gebruik van een oplossingsbestand of een package.config-bestand in het opgegeven projectpad.

Als u bijvoorbeeld alle pakketten voor MySolution.sln in de huidige map wilt herstellen, voert u het volgende uit:

nuget restore MySolution.sln

Opmerking

Voor niet-SDK-projecten die gebruik maken van PackageReference, gebruikt u msbuild -t:restore om pakketten te herstellen.

Zie Pakketten herstellenvoor meer informatie.

Volgende stappen