Polecenie update (interfejs wiersza NuGet)

Dotyczy: zużycie pakietu • Obsługiwane wersje: wszystkie

Aktualizuje wszystkie pakiety w projekcie (przy użyciu packages.config) do ich najnowszych dostępnych wersji. Zaleca się uruchomienie "przywracania" przed uruchomieniem .update (Aby zaktualizować pojedynczy pakiet, nuget install użyj bez określania numeru wersji. W takim przypadku NuGet zainstaluje najnowszą wersję).

Uwaga: update nie działa z interfejsem wiersza polecenia uruchomionym w systemie Mono (Mac OSX lub Linux) ani w przypadku korzystania z formatu PackageReference.

Polecenie update aktualizuje również odwołania do zestawu w pliku projektu, o ile te odwołania już istnieją. Jeśli zaktualizowany pakiet ma dodany zestaw, nowe odwołanie nie jest dodawane . Nowe zależności pakietów również nie mają dodanych odwołań do zestawu. Aby uwzględnić te operacje w ramach aktualizacji, zaktualizuj pakiet w programie Visual Studio użyciu interfejsu Menedżer pakietów lub konsoli Menedżer pakietów.

To polecenie może również służyć do aktualizowania nuget.exe za pomocą - self flagi.

Użycie

nuget update <configPath> [options]

gdzie <configPath> identyfikuje plik rozwiązania packages.config lub , który wyświetla listę zależności projektu.

Opcje

  • -ConfigFile

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

  • -DependencyVersion [Lowest, HighestPatch, HighestMinor, Highest, Ignore]

    Określa wersję pakietów zależności do użycia, która może być jedną z następujących czynności:

    • Najniższa (domyślna): najniższa wersja
    • HighestPatch: wersja z najniższą wersją główną, najniższą wersją pomocniczą, najwyższą poprawką
    • HighestMinor: wersja z najniższą wersją główną, najwyższą wersją pomocniczą, najwyższą poprawką
    • Najwyższa: najwyższa wersja
    • Ignoruj: nie będą używane żadne pakiety zależności

  • -FileConflictAction [PromptUser, Overwrite, Ignore]

    Określa akcję domyślną, gdy plik z pakietu już istnieje w projekcie docelowym. Ustaw wartość , Overwrite aby zawsze zastępować pliki. Ustaw wartość , Ignore aby pominąć pliki.

    Akcja PromptUser , domyślna, będzie monitować OverwriteAllIgnoreAll o każdy plik powodujące konflikt, chyba że zostanie podany lub , co będzie stosowane do wszystkich pozostałych plików.

  • -ForceEnglishOutput

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

  • -?|-help

    Wyświetla informacje pomocy dotyczące polecenia.

  • -Id

    Określa listę identyfikatorów pakietów do zaktualizowania.

  • -MSBuildPath

    (4.0+) Określa ścieżkę pliku MSBuild do użycia z poleceniem , mając pierwszeństwo przed -MSBuildVersion.

  • -MSBuildVersion

    (3.2+) Określa wersję pliku MSBuild do użyciu z tym poleceniem. Obsługiwane wartości to 4, 12, 14, 15.1, 15.3, 15.4, 15.5, 15.6, 15.7, 15.8, 15.9. Domyślnie jest MSBuild w ścieżce. W przeciwnym razie domyślnie jest wybierana najwyższa zainstalowana wersja MSBuild.

  • -NonInteractive

    Pomija monity o wprowadzenie danych przez użytkownika lub potwierdzenia.

  • -PreRelease

    Umożliwia aktualizowanie do wersji wstępnych. Ta flaga nie jest wymagana w przypadku aktualizowania już zainstalowanych pakietów w wstępną aktualizację.

  • -RepositoryPath

    Określa folder lokalny, w którym są instalowane pakiety.

  • -Safe

    Określa, że zostaną zainstalowane tylko aktualizacje z najwyższą wersją dostępną w ramach tej samej wersji główna i pomocnicza, w których zainstalowano pakiet.

  • -Self

    Aktualizacje nuget.exe do najnowszej wersji. -Source Można użyć, jednak wszystkie inne argumenty są ignorowane. Jeśli nie podano źródła, sprawdza aktualizacje nuget.org niezależnie od NuGet.Config ustawień.

  • -Source

    Określa listę źródeł pakietów (jako adresów URL) do użycia na użytek aktualizacji. W przypadku pominięcia polecenie używa źródeł podanych w plikach konfiguracji. Zobacz Typowe NuGet konfiguracji.

  • -Verbosity [normal|quiet|detailed]

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

  • -Version

    W przypadku korzystania z programu z jednym identyfikatorem pakietu określa wersję pakietu do zaktualizowania.

Zobacz też Zmienne środowiskowe

Przykłady

nuget update

# update packages installed in solution.sln, using MSBuild version 14.0 to load the solution and its project(s).
nuget update solution.sln -MSBuildVersion 14

nuget update -safe

nuget update -self