Freigeben über

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 auf einfache Weise zu installieren, zu deinstallieren und zu aktualisieren. In diesem Artikel werden die gängigsten dotnet CLI-Befehle zum Verwalten von NuGet-Paketen beschrieben.

Die dotnet CLI läuft auf .NET-, .NET Core-, .NET Standard SDK-Stil Projekte und andere SDK-Stil Projekte, zum Beispiel solche, die das .NET Framework zum Ziel haben. Weitere Informationen finden Sie unter .NET-Projekt-SDKs.

Für die meisten Befehle sucht das CLI-Tool im aktuellen Verzeichnis nach einer Projektdatei, es sei denn, eine andere Projektdatei wird als optionaler Schalter im Befehl angegeben. Eine vollständige Liste der Befehle und deren Argumente finden Sie unter dotnet CLI-Befehle.

Voraussetzungen

  • Das .NET Core SDK, das das dotnet Befehlszeilentool bereitstellt. Ab Visual Studio 2017 wird die dotnet CLI automatisch mit allen .NET- und .NET Core-bezogenen Workloads installiert.

Installieren oder Aktualisieren eines Pakets

Der Befehl "dotnet add package" fügt der Projektdatei einen Paketverweis hinzu und führt dann dotnet restore aus, um das Paket zu installieren.

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

  2. Verwenden Sie den folgenden Befehl, um ein NuGet-Paket zu installieren:

    dotnet add package <PACKAGE_NAME>

    Verwenden Sie z. B. den folgenden Befehl, um das Newtonsoft.Json Paket zu installieren.

    dotnet add package Newtonsoft.Json

  3. Nach Abschluss des Befehls können Sie die Projektdatei öffnen, um den Paketverweis anzuzeigen.

    Öffnen Sie z. B. die CSPROJ-Datei , um die hinzugefügte Newtonsoft.Json Paketreferenz 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 optional die Option -v oder --version.

dotnet add package <PACKAGE_NAME> -v <VERSION>

Verwenden Sie z. B. den folgenden Befehl, um Version 12.0.1 des Newtonsoft.Json Pakets hinzuzufügen:

dotnet add package Newtonsoft.Json --version 12.0.1

Liste der Paketreferenzen

Auflisten der Paketverweise und Versionen für Ihr Projekt mithilfe des Dotnet-Listenpaketbefehls :

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 den folgenden Befehl, um das Newtonsoft.Json Paket zu entfernen:

dotnet remove package Newtonsoft.Json

Pakete wiederherstellen

Der dotnet restore-Befehl stellt die Pakete wieder her, die von der Projektdatei aufgelistet werden <PackageReference>. Weitere Informationen finden Sie unter PackageReference in Projektdateien.

.NET Core 2.0 und höher dotnet build und dotnet run Befehle stellen Pakete automatisch wieder her. Ab NuGet 4.0 läuft dotnet restore denselben Code wie nuget restore.

So stellen Sie ein Paket mit dotnet restore wieder her:

  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

  • Last updated on