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.
- 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.
- Każde pobieranie jest plikiem
nuget.exebezpoś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. - 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.
Zainstaluj program Mono 4.4.2 lub nowszy.
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.exeUtwórz alias, dodając następujący skrypt do odpowiedniego pliku systemu operacyjnego (zazwyczaj
~/.bash_aliaseslub~/.bash_profile):# Create as alias for nuget alias nuget="mono /usr/local/bin/nuget.exe"Załaduj ponownie powłokę. Przetestuj instalację, wprowadzając
nugetbez 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 ,restoreiupdate. - Polecenia
pack,restore,delete,localsi sąpushró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).