Dokumentacja interfejsu wiersza polecenia narzędzia NuGet

Interfejs wiersza polecenia (CLI) nuget.exenuGet zapewnia pełny zakres funkcji NuGet do instalowania, tworzenia, publikowania i zarządzania pakietami bez wprowadzania jakichkolwiek zmian w plikach projektu.

Aby użyć dowolnego polecenia, otwórz okno polecenia lub powłokę bash, a następnie uruchom nuget polecenie i odpowiednie opcje, takie jak nuget help pack (aby wyświetlić pomoc w poleceniu pakietu).

Ta dokumentacja odzwierciedla najnowszą wersję interfejsu wiersza polecenia NuGet. Aby uzyskać szczegółowe informacje dotyczące danej używanej wersji, uruchom nuget help polecenie w celu uzyskania odpowiedniego polecenia.

Aby dowiedzieć się, jak używać podstawowych poleceń za pomocą interfejsu nuget.exe wiersza polecenia, zobacz Instalowanie i używanie pakietów przy użyciu interfejsu wiersza polecenia nuget.exe.

Instalowanie nuget.exe

Important

nuget.exeprogram jest obsługiwany tylko w Windows. Uruchamianie nuget.exe na platformie Mono nie jest obsługiwane, w tym w systemach Linux i macOS. W systemach Linux i macOS zamiast tego użyj interfejsu wiersza polecenia dotnet dołączonego do zestawu SDK .NET.

Zawsze zainstaluj najnowszą wersję narzędzia obsługującego konfigurację.

Jeśli narzędzie interfejsu nuget.exe wiersza polecenia jest już zainstalowane, możesz zaktualizować narzędzie do najnowszej wersji przy użyciu polecenia nuget update -self.

  1. Pobierz nuget.exeplik :

  2. Po wyświetleniu monitu zapisz plik w wybranym folderze. Plik nuget.exe jest pobierany bezpośrednio. Pobrany plik nie jest instalatorem, więc nie ma potrzeby uruchamiania pliku bezpośrednio z przeglądarki.

  3. Aby użyć narzędzia interfejsu wiersza polecenia z dowolnego folderu, dodaj folder zawierający plik nuget.exe do PATH zmiennej środowiskowej.

Wskazówka

Aby udostępnić interfejs wiersza polecenia NuGet w konsoli Menedżer pakietów w Visual Studio, zobacz Za pomocą interfejsu wiersza polecenia nuget.exe w konsoli.

dostępność

Aby uzyskać szczegółowe informacje, zobacz dostępność funkcji .

  • Wszystkie polecenia są dostępne w Windows.
  • nuget.exe nie jest obsługiwany w systemach Mono, Linux ani macOS.
  • Użyj interfejsu wiersza polecenia dotnet dla operacji NuGet w systemach Linux i macOS, w tym packpoleceń , restore, deletelocalsi push .

Polecenia i możliwość stosowania

Dostępne polecenia i możliwość stosowania do tworzenia pakietów, użycia pakietów i/lub publikowania pakietu na hoście:

Typowe polecenia Odpowiednie role Wersja narzędzia NuGet Opis
pakiet Creation 2.7+ Tworzy pakiet NuGet z .nuspec pliku lub projektu. Podczas uruchamiania w środowisku Mono tworzenie pakietu na podstawie pliku projektu nie jest obsługiwane.
push Publikowanie Wszystko Publikuje pakiet w źródle pakietu.
Config Wszystko Wszystko Pobiera lub ustawia wartości konfiguracji narzędzia NuGet.
pomoc lub ? Wszystko Wszystko Wyświetla informacje pomocy lub pomoc dla polecenia.
Mieszkańców Zużycie 3.3+ Wyświetla lokalizacje folderów global-packages, http-cache i temp oraz czyści zawartość tych folderów.
przywrócić Zużycie 2.7+ Przywraca wszystkie pakiety, do których odwołuje się używany format zarządzania pakietami. W przypadku uruchamiania w trybie Mono przywracanie pakietów przy użyciu formatu PackageReference nie jest obsługiwane.
setapikey Publikowanie, zużycie Wszystko Zapisuje klucz interfejsu API dla danego źródła pakietu, gdy to źródło pakietu wymaga klucza dostępu.
Spec Creation Wszystko Generuje plik .nuspec przy użyciu tokenów podczas generowania pliku z projektu Visual Studio.
Polecenia pomocnicze Odpowiednie role Wersja narzędzia NuGet Opis
dodaj Publikowanie 3.3+ Dodaje pakiet do źródła pakietu innego niż HTTP przy użyciu układu hierarchicznego. W przypadku źródeł HTTP użyj wypychania.
delete Publikowanie Wszystko Usuwa lub usuwa listę pakietu ze źródła pakietu.
init Creation 3.3+ Dodaje pakiety z folderu do źródła pakietu przy użyciu układu hierarchicznego.
instalacja Zużycie Wszystko Instaluje pakiet w bieżącym projekcie, ale nie modyfikuje projektów ani plików referencyjnych.
list Użycie, być może publikowanie Wszystko Wyświetla pakiety z danego źródła.
Lustro Publikowanie Przestarzałe w wersji 3.2 lub nowszej Dubluje pakiet i jego zależności od źródła do repozytorium docelowego.
wyszukiwanie Zużycie 5.8+ Wyszukuje dane źródło przy użyciu podanego ciągu zapytania.
Źródeł Użycie, publikowanie Wszystko Zarządza źródłami pakietów w plikach konfiguracji.
aktualizacja Zużycie Wszystko Aktualizuje pakiety projektu do najnowszych dostępnych wersji. Nieobsługiwane podczas uruchamiania w środowisku Mono.

Różne polecenia korzystają z różnych zmiennych środowiskowych.

Polecenia interfejsu wiersza polecenia narzędzia NuGet według odpowiednich ról:

roli Commands
Zużycie config, help, , , installlistlocalsrestoresearchsetapikeysourcesupdate
Creation config, , help, init, , packspec
Publikowanie add, config, , delete, helplist, , push, , setapikeysources

Deweloperzy zajmujący się tylko korzystaniem z pakietów, na przykład, muszą zrozumieć tylko ten podzbiór poleceń NuGet.

Uwaga / Notatka

Nazwy opcji poleceń są bez uwzględniania wielkości liter. Opcje, które są przestarzałe, nie są uwzględnione w tym odwołaniu, takie jak NoPrompt (zastąpione przez NonInteractive) i Verbose (zastąpione przez Verbosity).

Lokalizacja

NuGet.exepostęp, komunikaty ostrzegawcze i komunikaty o błędach są tłumaczone na te same ustawienia regionalne co Visual Studio. NuGet.exe jest dostarczany jako pojedynczy plik exe i ze względu na zagadnienia dotyczące rozmiaru tylko najczęściej wyświetlane komunikaty są tłumaczone we wszystkich językach.

  • Ostatnia aktualizacja o