Udostępnij za pośrednictwem

update command (NuGet CLI)

  • Artykuł

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

Aktualizacje wszystkie pakiety w projekcie (przy użyciu ) packages.configdo najnowszych dostępnych wersji. Zaleca się uruchomienie polecenia "restore" przed uruchomieniem polecenia update. (Aby zaktualizować pojedynczy pakiet, użyj nuget install polecenia bez określenia numeru wersji, w którym to przypadku program NuGet instaluje najnowszą wersję).

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

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

To polecenie może również służyć do aktualizowania nuget.exe się przy użyciu flagi -self .

Użycie

nuget update <configPath> [options]

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

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 [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 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

  • -FileConflictAction [PromptUser, Overwrite, Ignore]

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

    Akcja PromptUser domyślna spowoduje wyświetlenie monitu o podanie każdego pliku powodującego konflikt, chyba że OverwriteAll zostanie podany, IgnoreAll co będzie miało zastosowanie 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ę msBuild do użycia z poleceniem, pierwszeństwo przed -MSBuildVersion.

  • -MSBuildVersion

    (3.2+) Określa wersję programu MSBuild, która ma być używana 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 program MSBuild w ścieżce jest wybierany, w przeciwnym razie domyślnie jest to najwyższa zainstalowana wersja programu MSBuild.

  • -NonInteractive

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

  • -PreRelease

    Umożliwia aktualizowanie wersji wstępnych. Ta flaga nie jest wymagana podczas aktualizowania pakietów wstępnych, które są już zainstalowane.

  • -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 tej samej wersji głównej i pomocniczej co zainstalowany pakiet.

  • -Self

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

  • -Source

    Określa listę źródeł pakietów (jako adresy URL) do użycia dla aktualizacji. 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

    W przypadku użycia 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