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.

  1. Öffnen Sie eine Befehlszeile, und wechseln Sie zu dem Verzeichnis, das Ihre Projektdatei enthält.

  2. 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
    
  3. 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:

  1. Öffnen Sie eine Befehlszeile, und wechseln Sie zu dem Verzeichnis, das Ihre Projektdatei enthält.
  2. Führen Sie dotnet restore aus.

Nächste Schritte