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

Instalowanie nuget.exe

Windows

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.

macOS/Linux

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

Uwaga

Visual Studio dla komputerów Mac ma zostać wycofany do 31 sierpnia 2024 r.Nowoczesne zasady cyklu życia firmy Microsoft. Aby uzyskać więcej informacji, zobacz Co się dzieje z Visual Studio dla komputerów Mac.

1. Zainstaluj program Mono w wersji 4.4.2 lub nowszej.

2. Wykonaj następujące polecenie w wierszu polecenia powłoki:

   # 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. Utwórz alias, dodając następujący skrypt do odpowiedniego pliku dla systemu operacyjnego (zazwyczaj ~/.bash_aliases lub ~/.bash_profile):

   # Create as 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. Pomoc interfejsu wiersza polecenia narzędzia NuGet powinna być wyświetlana.

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.