NuGet interfejsu wiersza polecenia

Interfejs wiersza NuGet (CLInuget.exe) zapewnia pełny zakres funkcji interfejsu NuGet do instalowania, tworzenia i publikowania pakietów oraz zarządzania nimi bez konieczności dokonywania jakichkolwiek zmian w plikach projektu.

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

Ta dokumentacja odzwierciedla najnowszą wersję interfejsu wiersza NuGet wiersza polecenia. Aby uzyskać szczegółowe informacje dotyczące dowolnej wersji, z których korzystasz, uruchom polecenie nuget help dla żądanego 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 nuget.exe wiersza polecenia.

Instalowanie nuget.exe

Windows

Uwaga

NuGet.exe 5.0 i nowsze wymagają wykonania .NET Framework 4.7.2 lub nowszej.

  1. Odwiedź nuget.org/downloads i wybierz NuGet 3.3 lub wyższą (2.8.6 nie jest zgodne z mono). Zawsze zalecana jest najnowsza wersja, a do publikowania pakietów w programie nuget.org jest wymagana wersja 4.1.0 nuget.org.
  2. Każde pobieranie jest plikiem nuget.exe bezpośrednio. Poinstruuj przeglądarkę, aby zapisała plik w wybranego folderu. Plik nie jest instalatorem ; Jeśli uruchamiasz je bezpośrednio z przeglądarki, nic nie zobaczysz.
  3. Dodaj folder, w którym umieszczono zmienną nuget.exe środowiskową PATH, aby używać narzędzia interfejsu wiersza polecenia z dowolnego miejsca.

macOS/Linux

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

  1. Zainstaluj program Mono 4.4.2 lub nowszy.

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

    # 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 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 nuget bez parametrów. NuGet powinna być wyświetlana pomoc interfejsu wiersza polecenia.

Porada

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

Dostępność

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

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

Polecenia i możliwości stosowania

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

Typowe polecenia Odpowiednie role NuGet wersji Opis
pakiet Tworzenie 2.7+ Tworzy pakiet NuGet z pliku .nuspec projektu lub . W przypadku uruchamiania w programie 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 NuGet konfiguracji.
help or ? Wszystko Wszystko Wyświetla informacje o pomocy lub pomocy dotyczące polecenia.
locals Zużycie 3.3+ Wyświetla listę lokalizacji globalnych pakietów, pamięci podręcznej HTTP i folderów tymczasowych oraz czyszczy 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 Wszystko Zapisuje klucz interfejsu API dla danego źródła pakietu, gdy to źródło pakietu wymaga klucza w celu uzyskania dostępu.
spec Tworzenie Wszystko Generuje plik .nuspec przy użyciu tokenów w przypadku generowania pliku z projektu Visual Studio projektu.
Polecenia pomocnicze Odpowiednie role NuGet wersji Opis
add Publikowanie 3.3+ Dodaje pakiet do źródła pakietu bez protokołu HTTP przy użyciu układu hierarchicznego. W przypadku źródeł HTTP użyj wypychania.
delete Publikowanie Wszystko Usuwa lub usuwa listę pakietów 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 Wszystko Instaluje pakiet w bieżącym projekcie, ale nie modyfikuje projektów ani plików referencyjnych.
list Zużycie, na przykład publikowanie Wszystko Wyświetla pakiety z danego źródła.
mirror Publikowanie Przestarzałe w programie 3.2+ Dubluje pakiet i jego zależności z repozytorium źródłowego do docelowego.
search Zużycie 5.8+ Wyszukuje dane źródło przy użyciu podanego ciągu zapytania.
sources Zużycie, publikowanie Wszystko Zarządza źródłami pakietów w plikach konfiguracji.
update Zużycie Wszystko Aktualizuje pakiety projektu do najnowszych dostępnych wersji. Nie jest obsługiwana w przypadku uruchamiania na mono.

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

NuGet polecenia interfejsu wiersza polecenia według odpowiednich ról:

Rola Polecenia
Zużycie config, help, install, list, locals, restore, search, setapikey, sources, update
Tworzenie config, help, init, pack, spec
Publikowanie add, config, delete, help, list, push, setapikey, sources

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

Uwaga

W nazwach opcji poleceń nie jest uwzględniania ich litera. Opcje, które są przestarzałe, nie są uwzględnione w tym odwołaniu, NoPrompt takie jak ( NonInteractivezastąpione przez ) i Verbose (zastąpione przez Verbosity).