install — polecenie (interfejs wiersza polecenia NuGet)

Dotyczy: zużycie pakietów • Obsługiwane wersje: wszystkie

Pobiera i instaluje pakiet w projekcie, domyślnie w bieżącym folderze przy użyciu określonych źródeł pakietów.

Napiwek

Aby pobrać pakiet bezpośrednio poza kontekstem projektu, odwiedź stronę pakietu na nuget.org i wybierz link Pobierz.

Jeśli nie określono żadnych źródeł, są one wymienione w pliku konfiguracji globalnej, %appdata%\NuGet\NuGet.Config (Windows) lub ~/.nuget/NuGet/NuGet.Config (Mac/Linux), są używane. Aby uzyskać więcej informacji, zobacz Typowe konfiguracje pakietów NuGet.

Jeśli nie określono żadnych określonych pakietów, install instaluje wszystkie pakiety wymienione w pliku projektu packages.config , co sprawia, że jest on podobny do restore.

Polecenie install nie modyfikuje pliku projektu ani packages.configw ten sposób jest podobne do restore tego, że dodaje tylko pakiety do dysku, ale nie zmienia zależności projektu.

Aby dodać zależność, dodaj pakiet za pomocą interfejsu użytkownika Menedżer pakietów lub konsoli w programie Visual Studio albo zmodyfikuj packages.config polecenie , a następnie uruchom install polecenie lub restore.

Użycie

nuget install <packageID | configFilePath> [options]

gdzie <packageID> nazwa pakietu do zainstalowania (przy użyciu najnowszej wersji) lub <configFilePath> identyfikuje packages.config plik, który zawiera listę pakietów do zainstalowania. Możesz wskazać określoną wersję z opcją -Version .

Opcje

• -ConfigFile

  Plik konfiguracji NuGet do zastosowania. Jeśli nie zostanie określony, %AppData%\NuGet\NuGet.Config (Windows) lub ~/.config/NuGet/NuGet.Config~/.nuget/NuGet/NuGet.Config (Mac/Linux) zostanie użyty.

• -DependencyVersion

  (4.4+) Wersja pakietów zależności do użycia, która może być jedną z następujących opcji:
  

  • Najniższa (domyślna ): najniższa wersja
  • Najwyższapatch: wersja z najniższym głównym, najniższym mniejszą poprawką pomocniczą, najwyższą poprawką
  • HighestMinor: wersja o najniższym numerze głównym, najwyższa wersja pomocnicza, najwyższa poprawka
  • Najwyższa: najwyższa wersja
  • Ignoruj: nie będą używane żadne pakiety zależności

• -DirectDownload

  Pobieranie bezpośrednio bez wypełniania jakichkolwiek pamięci podręcznych z metadanymi lub plikami binarnymi.

• -DisableParallelProcessing

  Wyłącza równoległe instalowanie wielu pakietów.

• -x|-ExcludeVersion

  Instaluje pakiet w folderze o nazwie tylko z nazwą pakietu, a nie numerem wersji.

• -FallbackSource

  (3.2+) Lista źródeł pakietów, które mają być używane jako rezerwowe w przypadku, gdy pakiet nie zostanie znaleziony w podstawowym lub domyślnym źródle.

• -ForceEnglishOutput

  (3,5+) Wymusza nuget.exe uruchamiania przy użyciu niezmiennej kultury opartej na języku angielskim.

• -Framework

  (4.4+) Platforma docelowa używana do wybierania zależności. Wartość domyślna to "Any", jeśli nie zostanie określona.

• -?|-help

  Wyświetla informacje pomocy dotyczące polecenia .

• -NoHttpCache

  Uniemożliwia korzystanie z pakietów nuGet z pamięci podręcznej http. Zobacz Zarządzanie pakietami globalnymi i folderami pamięci podręcznej.

• -NonInteractive

  Pomija monity dotyczące danych wejściowych lub potwierdzanych przez użytkownika.

• -OutputDirectory

  Określa folder, w którym są instalowane pakiety. Jeśli nie określono żadnego folderu, używany jest bieżący folder.

• -PackageSaveMode

  Określa typy plików do zapisania po instalacji pakietu: jeden z nuspec, nupkglub nuspec;nupkg.

• -PreRelease

  Umożliwia zainstalowanie pakietów wstępnych. Ta flaga nie jest wymagana podczas przywracania pakietów za pomocą packages.configpolecenia .

• -RequireConsent

  Sprawdza, czy przywracanie pakietów jest włączone przed pobraniem i zainstalowaniem pakietów. Aby uzyskać szczegółowe informacje, zobacz Przywracanie pakietów.

• -SolutionDirectory

  Określa folder główny rozwiązania, dla którego mają być przywracane pakiety.

• -Source

  Określa listę źródeł pakietów (jako adresy URL) do użycia. Jeśli pominięto, polecenie używa źródeł podanych w plikach konfiguracji, zobacz Typowe konfiguracje NuGet.

• -Verbosity [normal|quiet|detailed]

  Określa ilość szczegółów wyświetlanych w danych wyjściowych: normal (wartość domyślna), quietlub detailed.

• -Version

  Określa wersję pakietu do zainstalowania.

Zobacz też Zmienne środowiskowe

Przykłady

nuget install elmah

nuget install packages.config

nuget install ninject -OutputDirectory c:\proj