Sdílet prostřednictvím

aktualizace balíčku dotnet

Tento článek se vztahuje na: ✔️ .NET 10 SDK a novější verze

Název

dotnet package update – Aktualizace odkazovaných balíčků v projektu

Přehled

dotnet package update [<packages>...]
    [--interactive] [--project <path>]
    [--verbosity <level>] [--vulnerable]

dotnet package update -h|--help

Description

Příkaz dotnet package update aktualizuje balíčky používané projekty. Pokud je povolen NuGetAudit , může se také pokusit automaticky aktualizovat balíčky se známými ohroženími zabezpečení na opravené verze.

Upozornění jako chyby

dotnet package update provádí implicitní obnovení, které kontroluje, jestli výsledný graf balíčků neobsahuje chyby. Použití --vulnerable také provede implicitní obnovení k vyhledání upozornění NuGetAudit. Pokud ale váš projekt používá WarningsAsErrors nebo TreatWarningsAsErrorsupozornění na obnovení NuGetu můžou způsobit selhání obnovení, což brání dokončení aktualizace.

Jako alternativní řešení doporučujeme využít podmínky nástroje MSBuild a proměnné prostředí, dokud se tento požadavek na funkci neimplementuje. Například nastavte <TreatWarningsAsErrors Condition=" '$(CustomCondition)' == ''>true</TreatWarningsAsErrors> v projektu a pak na většině linuxových a Mac shellů, které můžete spustit CustomCondition=true dotnet package update. Na příkazovém řádku Windows a PowerShellu budete muset nastavit proměnnou prostředí, spustit aktualizaci balíčku dotnet a pak proměnnou prostředí zrušit jako tři samostatné příkazy.

Arguments

  • packages

    Volitelný seznam balíčků, které se mají aktualizovat. Pokud nejsou k dispozici žádné balíčky, příkaz se pokusí aktualizovat všechny balíčky odkazované projektem. Balíčky mohou být název balíčku volitelně následovaný @ číslem verze a číslem verze. Například dotnet package update Contoso.Utilities nebo dotnet package update Contoso.Utilities@3.2.1. Pokud není k dispozici žádná verze, najde nejvyšší dostupnou verzi v nakonfigurovaných zdrojích balíčků.

Možnosti

  • --interactive

    Umožňuje příkazu zastavit a čekat na uživatelský vstup nebo akci. Například k dokončení ověřování.

  • --project <path>

    Projekt, ve kterém se mají balíčky aktualizovat. Pokud je adresář zadaný, vyhledá soubory projektu a řešení v adresáři. Výchozí hodnota je aktuální pracovní adresář.

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], , m[inimal]n[ormal], d[etailed]a diag[nostic]. Další informace najdete v tématu LoggerVerbosity.

  • --vulnerable

    Pokud obnovení hlásí, že některé balíčky mají známé chyby zabezpečení, tento příkaz tyto balíčky upgraduje. Pomocí této možnosti upgradujete balíčky na nejnižší verzi, která je vyšší než aktuálně odkazovaná verze, která neobsahuje žádná známá ohrožení zabezpečení.

  • -?|-h|--help

    Vytiskne popis použití příkazu.

Examples

  • Aktualizace všech balíčků v projektu na nejvyšší dostupnou verzi

    dotnet package update

    Updating outdated packages in S:\src\test\update\ConsoleApp1.
  ConsoleApp1:
    Updated Microsoft.Extensions.Configuration 9.0.0 to 9.0.9.
    Updated Microsoft.Extensions.DependencyInjection 9.0.0 to 9.0.9.

Updated 2 packages in 7 scanned packages.

  • Aktualizujte Contoso.Utilities na nejvyšší dostupnou verzi a Fabrikam.WebApi na verzi 1.2.3

    dotnet package update Contoso.Utilities Fabrikam.WebApi@1.2.3

    Updating outdated packages in S:\src\test\update\ConsoleApp1.
  ConsoleApp1:
    Updated Contoso.Utilities 2.3.1 to 2.4.6.
    Updated Fabrikam.WebApi 1.0.2 to 1.2.3.

Updated 2 packages in 2 scanned packages.

  • Aktualizace balíčků se známými ohroženími zabezpečení

    dotnet package update --vulnerable

    Updating packages with security advisories in S:\src\test\update\ConsoleApp1
  ConsoleApp1:
    Updating System.Text.Json 8.0.0 to 8.0.5.

Updated 1 packages in 31 scanned packages.
  • Last updated on