dotnet-csomag frissítése

Ez a cikk a következőre vonatkozik: ✔️ .NET 10 SDK és újabb verziók

Név

dotnet package update – Projekt hivatkozott csomagjainak frissítése.

Áttekintés

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

dotnet package update -h|--help

Description

A dotnet package update parancs frissíti a projektek által használt csomagokat. Ha a NuGetAudit engedélyezve van, megpróbálhatja automatikusan frissíteni az ismert biztonsági réseket tartalmazó csomagokat a rögzített verziókra.

Figyelmeztetések hibaként

dotnet package update implicit visszaállításokat végez annak ellenőrzéséhez, hogy az eredményként kapott csomagdiagram hibamentes-e. A NuGetAudit-figyelmeztetések --vulnerable megkereséséhez implicit visszaállítást is végez. Ha azonban a projekt használ WarningsAsErrors , vagy TreatWarningsAsErrorsa NuGet visszaállítási figyelmeztetései sikertelen visszaállítást okozhatnak, megakadályozva a frissítés befejezését.

Javasoljuk, hogy az MSBuild feltételek és környezeti változók előnyeit kerülő megoldásként használja a funkciókérés implementálásához. Állítsa be <TreatWarningsAsErrors Condition=" '$(CustomCondition)' == ''>true</TreatWarningsAsErrors> például a projektet, majd a legtöbb Linux- és Mac-rendszerhéjon futtatható CustomCondition=true dotnet package update. A Windows parancssorában és a PowerShellben be kell állítania a környezeti változót, futtatnia kell a dotnet-csomag frissítését, majd három külön parancsként kell feloldania a környezeti változót.

Arguments

• packages

  A frissítendő csomagok opcionális listája. Ha nincsenek megadva csomagok, a parancs megpróbálja frissíteni a projekt által hivatkozott összes csomagot. A csomagok lehetnek csomagnevek, amelyeket opcionálisan egy és egy @ verziószám követ. Például, dotnet package update Contoso.Utilities vagy dotnet package update Contoso.Utilities@3.2.1. Ha nincs megadva verzió, a rendszer a konfigurált csomagforrásokon elérhető legmagasabb verziót fogja megtalálni.

Beállítások

• --interactive

  Lehetővé teszi, hogy a parancs leálljon, és várja meg a felhasználói bemenetet vagy műveletet. Például a hitelesítés befejezéséhez.

• --project <path>

  Az a projekt, amelyben a csomagokat frissíteni kell. Ha rendelkezik címtárral, a címtárban projekt- és megoldásfájlokat keres. Az aktuális munkakönyvtár alapértelmezett értéke.

• -v|--verbosity <LEVEL>

  A parancs részletességi szintjét állítja be. Az engedélyezett értékek a következőkq[uiet]: , m[inimal], n[ormal]d[etailed]és diag[nostic]. További információért lásd LoggerVerbosity.

• --vulnerable

  Ha a visszaállítás ismert biztonsági réseket tartalmazó csomagokról számol be, ez a parancs frissíti ezeket a csomagokat. Ezzel a beállítással a csomagok a jelenleg hivatkozott verziónál magasabb, ismert biztonsági résekkel nem rendelkező legalacsonyabb verzióra frissülnek.

• -?|-h|--help

  A parancs használatának leírását nyomtatja ki.

Példák

• A projekt összes csomagjának frissítése a legmagasabb elérhető verzióra

  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.
  

• A Contoso.Utilities frissítése a legmagasabb elérhető verzióra, a Fabrikam.WebApi pedig az 1.2.3-ra

  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.
  

• Ismert biztonsági résekkel rendelkező csomagok frissítése

  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.