Installieren und Verwalten von NuGet-Paketen mit der dotnet-CLI
Sie können das dotnet CLI-Tool unter Windows, macOS oder Linux verwenden, um NuGet-Pakete in .NET-Projekten und -Lösungen einfach zu installieren, zu deinstallieren und zu aktualisieren. In diesem Artikel werden die am häufigsten verwendeten dotnet CLI-Befehle zum Verwalten von NuGet-Paketen beschrieben.
Die dotnet CLI wird auf .NET-, .NET Core-, .NET Standard-SDK-Formatprojekten und anderen SDK-Formatprojekten ausgeführt, z. B. für diejenigen, die .NET Framework zielen. Weitere Informationen finden Sie unter .NET-Projekt-SDKs.
Bei den meisten dieser Befehle sucht das CLI-Tool nach einer Projektdatei im aktuellen Verzeichnis, sofern keine Projektdatei im Befehl angegeben ist. Eine vollständige Liste der Befehle und deren Argumente finden Sie unter dotnet CLI-Befehle.
Voraussetzungen
- Das .NET Core SDK, das das Befehlszeilentool
dotnet
bietet. Ab Visual Studio 2017 wird die dotnet-CLI automatisch mit jeder .NET Core-bezogenen Workload installiert.
Installieren oder Aktualisieren eines Pakets
Über dotnet add package wird ein Paketverweis auf die Projektdatei hinzugefügt, anschließend wird dotnet restore
ausgeführt, um das Paket zu installieren.
Öffnen Sie eine Befehlszeile, und wechseln Sie zu dem Verzeichnis, das Ihre Projektdatei enthält.
Verwenden Sie folgenden Befehl, um ein NuGet-Paket zu installieren:
dotnet add package <PACKAGE_NAME>
Verwenden Sie beispielsweise zum Installieren des
Newtonsoft.Json
-Pakets den folgenden Befehl:dotnet add package Newtonsoft.Json
Nachdem der Befehl abgeschlossen ist, können Sie die Projektdatei öffnen, um den Paketverweis anzuzeigen.
Öffnen Sie beispielsweise die CSPROj-Datei , um den hinzugefügten
Newtonsoft.Json
Paketverweis anzuzeigen:<ItemGroup> <PackageReference Include="Newtonsoft.Json" Version="13.0.1" /> </ItemGroup>
Installieren einer bestimmten Paketversion
Der dotnet add package
Befehl installiert die neueste Version des Pakets, es sei denn, Sie geben eine andere Version an.
Um eine bestimmte Version eines NuGet-Pakets zu installieren, verwenden Sie die optionale -v
oder --version
switch:
dotnet add package <PACKAGE_NAME> -v <VERSION>
Verwenden Sie beispielsweise diesen Befehl, um Version 12.0.1 des Newtonsoft.Json
-Pakets hinzuzufügen:
dotnet add package Newtonsoft.Json --version 12.0.1
Auflisten von Paketverweisen
Listen Sie die Paketbezüge und -versionen für Ihr Projekt mit dem Befehl "dotnet list package " auf:
dotnet list package
Entfernen eines Pakets
Verwenden Sie den Befehl dotnet remove package, um einen Paketverweis aus der Projektdatei zu entfernen.
dotnet remove package <PACKAGE_NAME>
Verwenden Sie beispielsweise zum Entfernen des Newtonsoft.Json
-Pakets den folgenden Befehl:
dotnet remove package Newtonsoft.Json
Pakete wiederherstellen
Der Befehl "dotnet wiederherstellen " stellt Pakete wiederhergestellt, mit denen die Projektdatei listen <PackageReference>
. Weitere Informationen finden Sie unter PackageReference in Projektdateien.
.NET Core 2.0 und höher dotnet build
und dotnet run
Befehle wiederherstellen Pakete automatisch. Ab NuGet 4.0 wird derselbe Code ausgeführt wie für dotnet restore
.
So stellen Sie ein Paket mit dotnet restore
:
- Öffnen Sie eine Befehlszeile, und wechseln Sie zu dem Verzeichnis, das Ihre Projektdatei enthält.
- Führen Sie
dotnet restore
aus.