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

Windows

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 :

   • Aby pobrać najnowszą zalecaną wersję, przejdź do strony https://dist.nuget.org/win-x86-commandline/latest/nuget.exe.
   • Aby pobrać przestarzałą wersję 2.8.6, aby zachować zgodność ze starszymi systemami ciągłej integracji, przejdź do https://dist.nuget.org/win-x86-commandline/v2.8.6/nuget.exestrony . Wersja 2.8.6 nie jest zgodna z platformą Mono.
   • Aby wybrać wersję do pobrania, przejdź do nuget.org/downloads.
     • Wersja 5.0 lub nowsza wymagają platformy .NET Framework 4.7.2 lub nowszej.
     • Do publikowania pakietów w nuget.org jest wymagana wersja 4.1.0 lub nowsza.

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.

macOS/Linux

Zachowania mogą się nieznacznie różnić w zależności od dystrybucji systemu operacyjnego.

Uwaga / Notatka

Visual Studio dla komputerów Mac został wycofany 31 sierpnia 2024 r., zgodnie z zasadami nowoczesnego cyklu życia Microsoft. Możesz nadal pracować z Visual Studio dla komputerów Mac, ale istnieje kilka innych opcji dla deweloperów w systemie macOS, takich jak rozszerzenie C# Dev Kit dla programu VS Code.

Aby uzyskać więcej informacji na temat osi czasu i alternatyw pomocy technicznej, zobacz Visual Studio dla komputerów Mac wycofanych 31 sierpnia 2024.

1. Zainstaluj program Mono w wersji 4.4.2 lub nowszej.

2. W wierszu polecenia powłoki uruchom następujące polecenie:

   # Download the latest stable version of `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. Utwórz alias, dodając następujący kod do pliku używanego przez system operacyjny do przechowywania aliasów lub informacji o konfiguracji powłoki Bash. Zazwyczaj plik ~/.bash_aliases lub ~/.bash_profile jest używany do tego celu.

   # Create an alias for `nuget`.
   alias nuget="mono /usr/local/bin/nuget.exe"
   

4. Załaduj ponownie powłokę. Przetestuj instalację, wprowadzając polecenie nuget bez parametrów. Polecenie powinno wyświetlać informacje o pomocy interfejsu wiersza polecenia narzędzia NuGet na ekranie.

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.
• Wszystkie polecenia działają z nuget.exe uruchomionym w trybie Mono, z wyjątkiem przypadków, w których określono 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	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, , , localssourceslistrestoresearchsetapikeyinstallupdate
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.