Dokumentacja interfejsu wiersza polecenia narzędzia NuGet

  • Artykuł

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 pakietów i używanie ich przy użyciu interfejsu wiersza polecenia nuget.exe.

Instalowanie nuget.exe

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

  • Najnowszą zalecaną wersję można pobrać pod adresem https://dist.nuget.org/win-x86-commandline/latest/nuget.exe.
  • Jeśli masz już zainstalowane narzędzie interfejsu nuget.exe wiersza polecenia, możesz zaktualizować narzędzie do najnowszej wersji za pomocą polecenia nuget update -self.
  • Aby uzyskać zgodność ze starszymi systemami ciągłej integracji, https://nuget.org/nuget.exe poprzedni adres URL obecnie udostępnia przestarzałą wersję 2.8.6 narzędzia interfejsu wiersza polecenia.

  1. Odwiedź nuget.org/downloads i pobierz pakiet NuGet w wersji 3.3 lub nowszej.

    • Wersja 5.0 lub nowsza wymaga programu .NET Framework w wersji 4.7.2 lub nowszej.
    • Do publikowania pakietów nuget.orgw wersji 4.1.0 lub nowszej jest wymagany program .
    • Wersja 2.8.6 nie jest zgodna z platformą Mono.

  2. Każde pobieranie jest plikiem nuget.exe bezpośrednio. Poinstruuj przeglądarkę, aby zapisać plik w wybranym folderze. Plik pobierania nie jest instalatorem, więc nie widzisz niczego, jeśli plik zostanie uruchomiony bezpośrednio z przeglądarki.

  3. Aby użyć narzędzia interfejsu wiersza polecenia z dowolnego miejsca, dodaj lokalizację folderu dla nuget.exe pliku do zmiennej środowiskowej PATH.

Napiwek

Aby udostępnić interfejs wiersza polecenia NuGet w konsoli Menedżer pakietów w programie Visual Studio, zobacz Używanie interfejsu wiersza polecenia nuget.exe w konsoli programu .

Dostępność

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

  • Wszystkie polecenia są dostępne w systemie Windows.
  • Wszystkie polecenia działają z nuget.exe uruchomionym w trybie Mono, z wyjątkiem przypadków, w których wskazano wartości pack, restorei update.
  • Polecenia pack, restore, delete, localsi push są również dostępne na komputerach Mac i Linux za pośrednictwem interfejsu wiersza polecenia dotnet.

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 Tworzenie 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 wszystkie Publikuje pakiet w źródle pakietu.
config wszystkie wszystkie Pobiera lub ustawia wartości konfiguracji narzędzia NuGet.
help or ? wszystkie wszystkie Wyświetla informacje pomocy lub pomoc dla polecenia.
locals Zużycie 3.3+ Wyświetla lokalizacje folderów global-packages, http-cache i temp oraz czyści zawartość tych folderów.
restore 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 wszystkie Zapisuje klucz interfejsu API dla danego źródła pakietu, gdy to źródło pakietu wymaga klucza dostępu.
spec Tworzenie wszystkie .nuspec Generuje plik przy użyciu tokenów w przypadku generowania pliku z projektu programu Visual Studio.
Polecenia pomocnicze Odpowiednie role Wersja narzędzia NuGet opis
add 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.
usuwanie Publikowanie wszystkie Usuwa lub usuwa listę pakietu ze źródła pakietu.
init Tworzenie 3.3+ Dodaje pakiety z folderu do źródła pakietu przy użyciu układu hierarchicznego.
install Zużycie wszystkie Instaluje pakiet w bieżącym projekcie, ale nie modyfikuje projektów ani plików referencyjnych.
lista Użycie, być może publikowanie wszystkie Wyświetla pakiety z danego źródła.
mirror Publikowanie Przestarzałe w wersji 3.2 lub nowszej Dubluje pakiet i jego zależności od źródła do repozytorium docelowego.
search Zużycie 5.8+ Wyszukuje dane źródło przy użyciu podanego ciągu zapytania.
sources Użycie, publikowanie wszystkie Zarządza źródłami pakietów w plikach konfiguracji.
update Zużycie wszystkie Aktualizacje pakietów 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:

Rola Polecenia
Zużycie config, help, , , localssourceslistrestoresearchsetapikeyinstallupdate
Tworzenie config, , help, init, , packspec
Publikowanie add, config, , delete, listhelp, , push, , setapikeysources

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

Uwaga

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.exe postęp, komunikaty ostrzegawcze i komunikaty o błędach są tłumaczone na te same ustawienia regionalne co program 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.