NuGet Client-Tools installieren

  • Artikel

Sie möchten ein Paket installieren? Weitere Informationen unter Möglichkeiten zum Installieren von NuGet-Paketen.

Damit Sie als Paketverbraucher oder -ersteller mit NuGet arbeiten können, können Sie Befehlszeilenschnittstellentools (CLI) und NuGet-Features in Visual Studio verwenden. Dieser Artikel beschreibt kurz die Funktionen der verschiedenen Tools, wie sie installiert werden und ihre Verfügbarkeit von Features im Vergleich.

Um NuGet zum Konsumieren von Paketen zu verwenden, lesen Sie die folgenden Artikel:

Informationen zum Erstellen von NuGet-Paketen finden Sie in den folgenden Artikeln:

Tool Beschreibung Download
dotnet-SDK Das CLI-Tool für .NET Core- und .NET Standard-Bibliotheken und für beliebige Projekte im SDK-Format, z. B. ein Projekt für .NET Framework. Dieses CLI-Tool ist im .NET Core SDK enthalten und stellt NuGet-Kernfeatures auf allen Plattformen bereit. In Visual Studio 2017 und höher wird die dotnet CLI automatisch mit allen .NET Core-bezogenen Workloads installiert. .NET Core SDK
nuget.exe CLI-Tool für .NET Framework-Bibliotheken und für beliebige Projekte, im Nicht-SDK-Format, z. B. ein Projekt für .NET-Standard-Bibliotheken. Dieses CLI-Tool bietet alle Funktionen von NuGet unter Windows und die meisten Features für Mac und Linux unter Mono. nuget.exe
Visual Studio Unter Windows ist der NuGet-Paket-Manager in Visual Studio 2012 und höher enthalten. Visual Studio bietet die Benutzeroberfläche des Paket-Managers und die Konsole des Paket-Managers (PowerShell unter Windows). Sie können diese Tools verwenden, um die meisten NuGet-Vorgänge auszuführen. Visual Studio
Visual Studio für Mac Unter Mac sind bestimmte Funktionen von NuGet direkt integriert. Paket-Manager-Konsole ist derzeit nicht verfügbar. Verwenden Sie die dotnet-SDK oder nuget.exe-CLI-Tools für weitere Funktionen. Visual Studio für Mac
Visual Studio Code Unter Windows, Mac und Linux sind Funktionen von NuGet über Marketplace-Erweiterungen oder durch die Verwendung der CLI-Tools dotnet-SDK oder nuget.exe verfügbar. Visual Studio Code

Hinweis

Visual Studio für Mac wird am 31. August 2024 gemäß der Modern Lifecycle-Richtlinie von Microsoft eingestellt. Weitere Informationen finden Sie unter Was passiert mit Visual Studio für Mac.

Die MSBuild CLI stellt auch Pakete wieder her und erstellt sie. MSBuild ist kein Allzwecktool für die Arbeit mit NuGet. Dieses CLI-Tool ist in erster Linie auf Build-Servern nützlich.

Die Konsolenbefehle des Paket-Managers funktionieren nur in Visual Studio unter Windows und nicht in anderen PowerShell-Umgebungen.

Visual Studio

In Visual Studio 2017 und höher enthält das Visual Studio-Installationsprogramm den NuGet-Paketmanager mit allen Workloads, die .NET verwenden.

Sie können die Paket-Manager auch separat installieren oder ihre Installation überprüfen. Führen Sie das Visual-Studio-Installationsprogramm aus und überprüfen Sie die Optionseinstellung unter Einzelne Komponenten > Code-Tools > NuGet-Paket-Manager. Weitere Informationen finden Sie unter Installieren und Verwalten von Paketen in Visual Studio mit dem NuGet-Paket-Manager.

Hinweis

Für frühere Versionen von Visual Studio können Sie NuGet-Erweiterungen unter https://dist.nuget.org/index.html herunterladen.

CLI-Tools

Sie können entweder die dotnet-CLI oder die nuget.exe-CLI verwenden, um NuGet-Features in der Visual Studio IDE zu unterstützen. Die dotnet-CLI wird mit einigen Visual Studio-Workloads installiert, z. B. .NET Core. Die nuget.exe-CLI muss wie oben beschrieben separat installiert werden. Einen Vergleich der Funktionen der Tools finden Sie im Abschnitt über die Featureverfügbarkeit.

  • Für .NET Core oder .NET Standard verwenden Sie das dotnet-SDK-CLI-Tool. Dieses CLI ist für das SDK-ähnliche Projektformat erforderlich, das das SDK-Attribut verwendet.

  • Verwenden Sie für eine Ausrichtung auf .NET Framework (nur Nicht-SDK-Projekte) das nuget.exe-CLI-Tool. Wenn das Projekt von packages.config zu PackageReference migriert wird, verwenden Sie die dotnet-CLI.

dotnet-SDK

Das dotnet SDK ist das .NET Core 2.0 CLI-Tool, dass auf allen Plattformen (Windows, Mac und Linux) funktioniert und stellt NuGet-Kernfeatures bereit, wie z. B. das Installieren, Wiederherstellen und Veröffentlichen von Paketen. Durch die dotnet-CLI wird die direkte Integration von .NET Core-Projektdateien (z. B. .csproj) ermöglicht, was in den meisten Szenarios hilfreich ist. Dieses CLI wird auch für jede Plattform direkt erstellt und erfordert keine Installation von Mono.

Installieren Sie das dotnet-SDK

Informationen zur Verwendung grundlegender Befehle des dotnet-SDK-CLI-Tools finden Sie unter Installieren und Verwalten von NuGetPaketen mit der dotnet-CLI.

nuget.exe-CLI

NuGet CLI, nuget.exe, ist das Befehlszeilen-Hilfsprogramm für Windows, das alle NuGet-Funktionen bereitstellt. Diese CLI kann auch unter Mac OSX und Linux unter Verwendung von Mono mit einigen Einschränkungen ausgeführt werden.

Informationen zur Verwendung grundlegender Befehle mit dem nuget.exe-CLI-Tool finden Sie unter Verwalten von NuGet-Paketen mit der nuget.exe-CLI.

Installieren von nuget.exe

Installieren Sie immer die neueste Version des Tools, das Ihre Konfiguration unterstützt.

  • Sie können die neueste empfohlene Version unter https://dist.nuget.org/win-x86-commandline/latest/nuget.exe herunterladen.
  • Wenn Sie das nuget.exe-CLI-Tool bereits installiert haben, können Sie das Tool mit dem Befehl nuget update -self auf die aktuelle Version aktualisieren.
  • Für die Kompatibilität mit älteren Continuous Integration-Systemen wird aktuell über die vorherige URL, https://nuget.org/nuget.exe, die veraltete Version 2.8.6 des CLI-Tools zur Verfügung gestellt.

  1. Besuchen Sie nuget.org/downloads und laden Sie NuGet-Version 3.3 oder höher herunter.

    • Version 5.0 und höher erfordert .NET Framework Version 4.7.2 oder höher.
    • Version 4.1.0 und höher ist erforderlich, um Pakete auf nuget.org zu veröffentlichen.
    • Version 2.8.6 ist nicht mit Mono kompatibel.

  2. Jeder Download ist direkt die Datei nuget.exe. Weisen Sie Ihren Browser an, die Datei in einem Ordner Ihrer Wahl zu speichern. Der Download ist kein Installationsprogramm, d. h. Sie sehen nichts, wenn Sie die Datei direkt über den Browser ausführen.

  3. Um das CLI-Tool von einem beliebigen Ort aus zu verwenden, fügen Sie den Speicherort der nuget.exe-Datei zu Ihrer Umgebungsvariablen PATH hinzu.

Verfügbarkeit von Funktionen

In der folgenden Tabelle werden die verfügbaren Funktionen für die dotnet- und nuget.exe-CLI-Tools für unterstützte Plattformen verglichen.

Funktion dotnet-CLI NuGet-CLI (Windows) NuGet-CLI (Mono) Visual Studio (Windows) Visual Studio für Mac
Suchen von Paketen ✔ ✔ ✔ ✔
Pakete installieren oder deinstallieren ✔ ✔ (1) ✔ ✔ ✔
Aktualisieren von Paketen ✔ ✔ ✔ ✔
Pakete wiederherstellen ✔ ✔ ✔ (2) ✔ ✔
Paketfeeds verwalten (Quellen) ✔ ✔ ✔ ✔
Pakete auf einem Feed verwalten ✔ ✔ ✔
API-Schlüsseln für Feeds festlegen ✔ ✔
Pakete erstellen (3) ✔ ✔ ✔ (4) ✔
Veröffentlichen von Paketen ✔ ✔ ✔ ✔
Pakete replizieren ✔ ✔
Verwalten des Ordners global-packages und des Cacheordners ✔ ✔ ✔
NuGet-Konfiguration verwalten ✔ ✔

Featurehinweise

  • (1) Wirkt sich nicht auf Projektdateien aus. Verwenden Sie stattdessen das dotnet-SDK-CLI-Tool.
  • (2) Funktioniert nur mit der packages.config-Datei und nicht mit Projektmappendateien (.sln).
  • (3) Verschiedene fortgeschrittene Paketfeatures sind nur über die CLI verfügbar, sie werden nicht in den Tools der Visual Studio-Benutzeroberfläche dargestellt.
  • (4) Funktioniert bei .nuspec-Dateien, jedoch nicht bei Projektdateien.

Kommende Funktionen

Wenn Sie eine Vorschau der geplanten NuGet-Features sehen möchten, installieren Sie eine Visual Studio Preview, die mit stabilen Releases von Visual Studio zusammenarbeitet. Wenn Sie Probleme melden oder Ideen für Vorschauversionen teilen möchten, können Sie sich am GitHub-Repository von NuGet beteiligen.

Entwickler, die unter Windows arbeiten, können auch den NuGet Package Explorer nutzen. Diese Anwendung ist ein eigenständiges Open-Source-Tool, mit dem Sie NuGet-Pakete visuell untersuchen, erstellen und bearbeiten können. Dies ist für viele Szenarien hilfreich, z. B. um experimentelle Änderungen an einer Paketstruktur vorzunehmen, ohne das Paket neu zu erstellen.