Condividi tramite


aggiornamento del pacchetto dotnet

Questo articolo si applica a: ✔️ .NET 10 SDK e versioni successive

Nome

dotnet package update - Aggiornare i pacchetti a cui si fa riferimento in un progetto.

Synopsis

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

dotnet package update -h|--help

Description

Il dotnet package update comando aggiorna i pacchetti usati dai progetti. Se NuGetAudit è abilitato, può anche tentare di aggiornare automaticamente i pacchetti di aggiornamento con vulnerabilità note alle versioni fisse.

Avvisi come errori

dotnet package update esegue ripristini impliciti per verificare se il grafico del pacchetto risultante è privo di errori. L'uso di --vulnerable esegue anche un ripristino implicito per trovare gli avvisi di NuGetAudit. Tuttavia, se il progetto usa WarningsAsErrors o TreatWarningsAsErrors, gli avvisi di ripristino di NuGet possono causare errori di ripristino, impedendo il completamento dell'aggiornamento.

È consigliabile sfruttare le condizioni di MSBuild e le variabili di ambiente come soluzione alternativa fino a quando non viene implementata questa richiesta di funzionalità . Ad esempio, impostare <TreatWarningsAsErrors Condition=" '$(CustomCondition)' == ''>true</TreatWarningsAsErrors> nel progetto e quindi nella maggior parte delle shell Linux e Mac è possibile eseguire CustomCondition=true dotnet package update. Nel prompt dei comandi di Windows e PowerShell è necessario impostare la variabile di ambiente, eseguire l'aggiornamento del pacchetto dotnet, quindi annullare l'impostazione della variabile di ambiente come tre comandi separati.

Arguments

  • packages

    Elenco facoltativo di pacchetti da aggiornare. Quando non vengono forniti pacchetti, il comando tenterà di aggiornare tutti i pacchetti a cui fa riferimento il progetto. I pacchetti possono essere un nome di pacchetto facoltativamente seguito da un @ numero di versione e . Ad esempio, dotnet package update Contoso.Utilities o dotnet package update Contoso.Utilities@3.2.1. Quando non viene fornita alcuna versione, troverà la versione più recente disponibile nelle origini del pacchetto configurate.

Options

  • --interactive

    Consente al comando di arrestarsi e attendere l'input o l'azione dell'utente, ad esempio il completamento dell'autenticazione.

  • --project <path>

    Progetto in cui devono essere aggiornati i pacchetti. Se viene specificata una directory, cerca i file di progetto e di soluzione nella directory. Il valore predefinito è la directory di lavoro corrente.

  • -v|--verbosity <LEVEL>

    Imposta il livello di dettaglio del comando. I valori consentiti sono q[uiet], m[inimal], n[ormal], d[etailed] e diag[nostic]. Per altre informazioni, vedere LoggerVerbosity.

  • --vulnerable

    Se il ripristino segnala eventuali pacchetti come vulnerabilità note, questo comando aggiornerà tali pacchetti. L'uso di questa opzione consente di aggiornare i pacchetti alla versione più bassa di quella attualmente a cui si fa riferimento, che non presenta vulnerabilità note.

  • -?|-h|--help

    Stampa una descrizione di come usare il comando .

Esempi

  • Aggiornare tutti i pacchetti nel progetto alla versione più recente disponibile

    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.
    
  • Aggiornare Contoso.Utilities alla versione più recente disponibile e Fabrikam.WebApi alla versione 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.
    
  • Aggiornare i pacchetti con vulnerabilità note

    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.