příkaz update (rozhraní příkazového řádku NuGet)

  • Článek

Platí pro: spotřeba balíčků • Podporované verze: vše

Aktualizace všechny balíčky v projektu (pomocípackages.config) na nejnovější dostupné verze. Před spuštěním příkazu updatese doporučuje spustit příkaz "restore". (Chcete-li aktualizovat jednotlivé balíčky, použijte nuget install bez zadání čísla verze, v takovém případě NuGet nainstaluje nejnovější verzi.)

Poznámka: update Nefunguje s rozhraním příkazového řádku spuštěným v Mono (Mac OSX nebo Linux) nebo při použití formátu PackageReference.

Příkaz update také aktualizuje odkazy na sestavení v souboru projektu za předpokladu, že tyto odkazy již existují. Pokud má aktualizovaný balíček přidané sestavení, nepřidá se nový odkaz. Nové závislosti balíčků také nemají přidané odkazy na sestavení. Pokud chcete tyto operace zahrnout jako součást aktualizace, aktualizujte balíček v sadě Visual Studio pomocí uživatelského rozhraní Správce balíčků nebo konzoly Správce balíčků.

Tento příkaz lze také použít k aktualizaci nuget.exe samotné pomocí příznaku -self .

Využití

nuget update <configPath> [options]

kde <configPath> identifikuje soubor packages.config řešení, který obsahuje závislosti projektu.

Možnosti

  • -ConfigFile

    Konfigurační soubor NuGet, který se má použít. Pokud není zadaný, %AppData%\NuGet\NuGet.Config (Windows) nebo ~/.nuget/NuGet/NuGet.Config~/.config/NuGet/NuGet.Config (Mac/Linux), použije se.

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

    Určuje verzi balíčků závislostí, které se mají použít, což může být jedna z následujících možností:

    • Nejnižší (výchozí): nejnižší verze
    • HighestPatch: verze s nejnižším hlavním, nejnižším podverzem, nejvyšší opravou
    • HighestMinor: verze s nejnižší hlavní, nejvyšší podverze, nejvyšší oprava
    • Nejvyšší: nejvyšší verze
    • Ignorovat: Nebudou použity žádné balíčky závislostí.

  • -FileConflictAction [PromptUser, Overwrite, Ignore]

    Určuje výchozí akci, pokud soubor z balíčku již v cílovém projektu existuje. Nastaví se tak, aby Overwrite vždy přepsaly soubory. Nastavení pro Ignore přeskočení souborů

    Ve PromptUser výchozím nastavení se zobrazí výzva ke každému konfliktnímu souboru, pokud OverwriteAll není k dispozici, IgnoreAll což se použije u všech zbývajících souborů.

  • -ForceEnglishOutput

    (3,5+) Vynutí spuštění nuget.exe pomocí invariantní anglické jazykové verze.

  • -?|-help

    Zobrazí informace nápovědy pro příkaz.

  • -Id

    Určuje seznam ID balíčků, které se mají aktualizovat.

  • -MSBuildPath

    (4.0+) Určuje cestu nástroje MSBuild, která se má použít s příkazem a má přednost před -MSBuildVersion.

  • -MSBuildVersion

    (3.2+) Určuje verzi nástroje MSBuild, která se má použít s tímto příkazem. Podporované hodnoty jsou 4, 12, 14, 15.1, 15.3, 15.4, 15.5, 15.6, 15.7, 15.8, 15.9. Ve výchozím nastavení se vybere msBuild ve vaší cestě, jinak se ve výchozím nastavení nastaví na nejvyšší nainstalovanou verzi nástroje MSBuild.

  • -NonInteractive

    Potlačí výzvy k zadání uživatelského vstupu nebo potvrzení.

  • -PreRelease

    Umožňuje aktualizaci předběžné verze. Tento příznak se nevyžaduje při aktualizaci předem nainstalovaných balíčků.

  • -RepositoryPath

    Určuje místní složku, do které se instalují balíčky.

  • -Safe

    Určuje, že se nainstalují pouze aktualizace s nejvyšší verzí dostupnou ve stejné hlavní a podverzi jako nainstalovaný balíček.

  • -Self

    nuget.exe Aktualizace na nejnovější verzi. -Source lze však použít všechny ostatní argumenty, které jsou ignorovány. Pokud není k dispozici žádný zdroj, zkontroluje nuget.org aktualizace bez NuGet.Config ohledu na nastavení.

  • -Source

    Určuje seznam zdrojů balíčků (jako adresy URL), které se mají použít pro aktualizace. Pokud tento příkaz vynecháte, použije zdroje uvedené v konfiguračních souborech, viz běžné konfigurace NuGetu.

  • -Verbosity [normal|quiet|detailed]

    Určuje množství podrobností zobrazených ve výstupu: normal (výchozí), quietnebo detailed.

  • -Version

    Při použití s jedním ID balíčku určuje verzi balíčku, která se má aktualizovat.

Viz také proměnné prostředí.

Příklady

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