Verweis auf NuGet-CLI

Die nuget-Befehlszeilenschnittstelle (CLI) nuget.exe bietet das gesamte Maß an nuget-Funktionen, um Pakete zu installieren, zu erstellen, zu veröffentlichen und zu verwalten, ohne dass Änderungen an den Projektdateien vorgenommen werden.

Um einen beliebigen Befehl zu verwenden, öffnen Sie ein Befehlsfenster oder eine bash-Shell, und führen Sie dann nuget aus, gefolgt vom Befehl und den entsprechenden Optionen, z nuget help pack . b. (zum Anzeigen der Hilfe zum Befehl Pack).

Diese Dokumentation spiegelt die neueste Version der nuget-CLI wider. Führen Sie für den gewünschten Befehl aus, um genaue Informationen zu einer beliebigen Version zu erhalten, die Sie verwenden nuget help .

Informationen zur Verwendung grundlegender Befehle der nuget.exe-CLI finden Sie unter Installieren und Verwenden von Paketen mit der nuget.exe-CLI.

Installieren von nuget.exe

Windows

Hinweis

Für die Ausführung von NuGet.exe 5.0 und höher ist .NET Framework 4.7.2 erforderlich.

  1. Besuchen Sie nuget.org/downloads, und wählen Sie NuGet 3.3 oder höher aus (2.8.6 ist nicht kompatibel mit Mono). Die neueste Version wird immer empfohlen, und 4.1.0+ ist erforderlich, um Pakete in „nuget.org“ zu veröffentlichen.
  2. Jeder Download ist direkt die Datei nuget.exe. Weisen Sie Ihren Browser an, die Datei in einem Ordner Ihrer Wahl zu speichern. Die Datei ist kein Installationsprogramm; es wird nichts angezeigt, wenn Sie es direkt über den Browser ausführen.
  3. Fügen Sie den Ordner, in dem Sie nuget.exe platziert haben, Ihrer Umgebungsvariablen PATH hinzu, um das CLI-Tool von überall aus verwenden zu können.

macOS/Linux

Das Verhalten kann je nach Betriebssystemdistribution leicht variieren.

  1. Installieren Sie Mono 4.4.2 oder höher.

  2. Führen Sie an einer Shelleingabeaufforderung folgenden Befehl aus:

    # Download the latest stable `nuget.exe` to `/usr/local/bin`
    sudo curl -o /usr/local/bin/nuget.exe https://dist.nuget.org/win-x86-commandline/latest/nuget.exe
    
  3. Erstellen Sie einen Alias, indem Sie das folgende Skript der entsprechenden Datei für Ihr Betriebssystem hinzufügen (in der Regel ~/.bash_aliases oder ~/.bash_profile):

    # Create as alias for nuget
    alias nuget="mono /usr/local/bin/nuget.exe"
    
  4. Laden Sie die Shell neu. Testen Sie die Installation, indem Sie nuget ohne Parameter eingeben. Die NuGet-CLI-Hilfe sollte angezeigt werden.

Tipp

Informationen dazu, wie Sie die nuget-CLI in der Paket-Manager-Konsole in Visual Studio verfügbar machen, finden Sie unter Verwenden der nuget.exe CLI in der Konsole.

Verfügbarkeit

Genaue Informationen finden Sie unter Verfügbarkeit von Features .

  • Alle Befehle sind unter Windows verfügbar.
  • Alle Befehle funktionieren mit nuget.exe, die unter Mono ausgeführt werden, außer wenn für pack , und angegeben ist restore update .
  • Die pack restore Befehle,, delete , locals und push sind auch unter Mac und Linux über die dotnet-CLI verfügbar.

Befehle und Anwendbarkeit

Verfügbare Befehle und Anwendbarkeit bei der Paket Erstellung, dem Paket Verbrauch und/oder dem Veröffentlichen eines Pakets auf einem Host:

Allgemeine Befehle Anwendbare Rollen NuGet-Version BESCHREIBUNG
pack Erstellung 2.7 und höher Erstellt ein nuget-Paket aus einer- .nuspec oder-Projektdatei. Wenn Sie unter Mono ausführen, wird das Erstellen eines Pakets aus einer Projektdatei nicht unterstützt.
push Veröffentlichung All Veröffentlicht ein Paket in einer Paketquelle.
config All All Ruft nuget-Konfigurationswerte ab oder legt Sie fest.
help or ? All All Zeigt Hilfe Informationen oder Hilfe zu einem Befehl an.
locals Nutzung 3.3 und höher Listet die Speicherorte der Ordner " Global-Packages", " http-Cache" und " Temp " auf und löscht den Inhalt dieser Ordner.
restore Nutzung 2.7 und höher Stellt alle Pakete wieder her, auf die im verwendeten Paket Verwaltungs Format verwiesen wird. Bei der Ausführung unter Mono wird das Wiederherstellen von Paketen mit dem packagereferenzierungsformat nicht unterstützt.
setapikey Veröffentlichen, Verbrauch All Speichert einen API-Schlüssel für eine bestimmte Paketquelle, wenn diese Paketquelle einen Schlüssel für den Zugriff benötigt.
spec Erstellung All Generiert eine .nuspec Datei mithilfe von Token, wenn die Datei aus einem Visual Studio-Projekt generiert wird.
Sekundäre Befehle Anwendbare Rollen NuGet-Version BESCHREIBUNG
add Veröffentlichung 3.3 und höher Fügt mithilfe des hierarchischen Layouts ein Paket zu einer nicht-http-Paketquelle hinzu. Verwenden Sie für http-Quellen Push.
delete Veröffentlichung All Entfernt oder hebt die Auflistung eines Pakets aus einer Paketquelle auf.
init Erstellung 3.3 und höher Fügt mithilfe des hierarchischen Layouts Pakete aus einem Ordner einer Paketquelle hinzu.
install Nutzung All Installiert ein Paket im aktuellen Projekt, ändert jedoch keine Projekte oder Verweis Dateien.
list Verbrauch, vielleicht veröffentlichen All Zeigt Pakete aus einer angegebenen Quelle an.
mirror Veröffentlichung Veraltet in 3.2 + Spiegelt ein Paket und seine Abhängigkeiten von einer Quelle in ein Zielrepository ein.
search Nutzung 5.8 + Durchsucht eine angegebene Quelle mithilfe der angegebenen Abfrage Zeichenfolge.
sources Verbrauch, Veröffentlichung All Verwaltet Paketquellen in Konfigurationsdateien.
update Nutzung All Aktualisiert die Pakete eines Projekts auf die neuesten verfügbaren Versionen. Wird nicht unterstützt, wenn Sie unter Mono ausgeführt wird.

Verschiedene Befehle verwenden verschiedene Umgebungsvariablen.

Nuget-CLI-Befehle nach anwendbaren Rollen:

Rolle Befehle
Nutzung config, help, install, list, locals, restore, search, setapikey, sources, update
Erstellung config, help, init, pack, spec
Veröffentlichung add, config, delete, help, list, push, setapikey, sources

Entwickler, die sich nur mit der Verwendung von Paketen beschäftigen, benötigen beispielsweise nur diese Teilmenge von nuget-Befehlen.

Hinweis

Bei Befehls Optionsnamen wird die Groß-/Kleinschreibung beachtet Veraltete Optionen sind in diesem Verweis nicht enthalten, z NoPrompt . b. (ersetzt durch NonInteractive ) und Verbose (ersetzt durch Verbosity ).