Verweis auf NuGet-CLI
Die NuGet-Befehlszeilenschnittstelle (CLI) nuget.exebietet das vollständige Ausmaß der NuGet-Funktionalität zum Installieren, Erstellen, Veröffentlichen und Verwalten von Paketen, ohne Änderungen an Projektdateien vorzunehmen.
Um einen beliebigen Befehl zu verwenden, öffnen Sie ein Befehlsfenster oder eine Bash-Shell, und führen Sie nuget dann gefolgt von dem Befehl und den entsprechenden Optionen aus, z nuget help pack . B. (um Hilfe zum Packbefehl anzuzeigen).
Diese Dokumentation spiegelt die neueste Version der NuGet CLI wider. Wenn Sie genaue Details für jede version benötigen, die Sie verwenden, führen Sie die Ausführung nuget help für den gewünschten Befehl aus.
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.
- 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.
- 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. - Fügen Sie den Ordner, in dem Sie
nuget.exeplatziert 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.
Installieren Sie Mono 4.4.2 oder höher.
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.exeErstellen Sie einen Alias, indem Sie das folgende Skript der entsprechenden Datei für Ihr Betriebssystem hinzufügen (in der Regel
~/.bash_aliasesoder~/.bash_profile):# Create as alias for nuget alias nuget="mono /usr/local/bin/nuget.exe"Laden Sie die Shell neu. Testen Sie die Installation, indem Sie
nugetohne Parameter eingeben. Die NuGet-CLI-Hilfe sollte angezeigt werden.
Tipp
Informationen zum Verfügbarmachen der NuGet CLI in der Paket-Manager-Konsole in Visual Studio finden Sie unter Verwenden der nuget.exe CLI in der Konsole.
Verfügbarkeit
Ausführliche Informationen finden Sie unter Featureverfügbarkeit .
- Alle Befehle sind unter Windows verfügbar.
- Alle Befehle funktionieren mit nuget.exe, die auf Mono ausgeführt werden, außer wenn für
pack,restoreundupdate. - Die
packBefehle ,restore, ,deleteundpushlocalsBefehle sind auch auf Mac und Linux über die dotnet CLI verfügbar.
Befehle und Anwendbarkeit
Verfügbare Befehle und Anwendbarkeit auf Paketerstellung, Paketverbrauch und/oder Veröffentlichung 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 einer Projektdatei. Wenn sie auf Mono ausgeführt wird, 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 | Dient zum Abrufen oder Festlegen von NuGet-Konfigurationswerten. |
| help or ? | All | All | Zeigt Hilfeinformationen oder Hilfe für einen Befehl an. |
| locals | Verbrauch | 3.3+ | Listet Speicherorte der globalen Pakete, des HTTP-Caches und der temporären Ordner auf und löscht den Inhalt dieser Ordner. |
| restore | Verbrauch | 2.7 und höher | Stellt alle Pakete wieder her, auf die im Paketverwaltungsformat verwiesen wird. Beim Ausführen auf Mono wird das Wiederherstellen von Paketen mit dem PackageReference-Format nicht unterstützt. |
| setapikey | Veröffentlichung, Verbrauch | All | Speichert einen API-Schlüssel für eine bestimmte Paketquelle, wenn für diese Paketquelle ein Schlüssel für den Zugriff erforderlich ist. |
| spec | Erstellung | All | Generiert eine .nuspec Datei mit Token, wenn die Datei aus einem Visual Studio-Projekt generiert wird. |
| Sekundäre Befehle | Anwendbare Rollen | NuGet-Version | Beschreibung |
|---|---|---|---|
| add | Veröffentlichung | 3.3+ | Fügt ein Paket zu einer Nicht-HTTP-Paketquelle mit hierarchischem Layout hinzu. Verwenden Sie für HTTP-Quellen Push. |
| Löschen | Veröffentlichung | All | Entfernt oder hebt die Liste eines Pakets aus einer Paketquelle auf. |
| init | Erstellung | 3.3+ | Fügt Pakete aus einem Ordner zu einer Paketquelle mithilfe des hierarchischen Layouts hinzu. |
| Installieren | Verbrauch | All | Installiert ein Paket im aktuellen Projekt, ändert jedoch keine Projekte oder Referenzdateien. |
| list | Konsum, vielleicht Veröffentlichung | All | Zeigt Pakete aus einer bestimmten Quelle an. |
| mirror | Veröffentlichung | Veraltet in 3.2+ | Spiegelt ein Paket und seine Abhängigkeiten von einer Quelle in ein Ziel-Repository. |
| search | Verbrauch | 5.8+ | Durchsucht eine bestimmte Quelle mithilfe der bereitgestellten Abfragezeichenfolge. |
| sources | Verbrauch, Veröffentlichung | All | Verwaltet Paketquellen in Konfigurationsdateien. |
| Aktualisierung | Verbrauch | All | Aktualisiert die Pakete eines Projekts auf die neuesten verfügbaren Versionen. Wird nicht unterstützt, wenn sie auf Mono ausgeführt wird. |
Verschiedene Befehle verwenden verschiedene Umgebungsvariablen.
NuGet CLI-Befehle nach anwendbaren Rollen:
| Role | Befehle |
|---|---|
| Verbrauch | 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 dem Verbrauch von Paketen befassen, müssen beispielsweise nur verstehen, dass eine Teilmenge von NuGet-Befehlen vorhanden ist.
Hinweis
Bei Befehlsoptionsnamen wird die Groß-/Kleinschreibung nicht beachtet. Veraltete Optionen sind in diesem Verweis nicht enthalten, z NoPrompt . B. (ersetzt durch NonInteractive) und Verbose (ersetzt durch Verbosity).
Lokalisierung
NuGet.exe Fortschritts-, Warnungs- und Fehlermeldungen werden in die gleichen Gebietsschemas wie Visual Studio übersetzt. NuGet.exe wird als einzelne Exe ausgeliefert, und aufgrund von Größenüberlegungen werden nur die am häufigsten angezeigten Nachrichten in allen Sprachen übersetzt.