Udostępnij za pośrednictwem

install — polecenie (interfejs wiersza polecenia NuGet)

  • Artykuł

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