atualização do pacote dotnet

Este artigo se aplica a: ✔️ SDK do .NET 10 e versões posteriores

Nome

dotnet package update – Atualizar pacotes referenciados em um projeto.

Sinopse

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

dotnet package update -h|--help

Description

O dotnet package update comando atualiza os pacotes usados pelos projetos. Se o NuGetAudit estiver habilitado, ele também poderá tentar atualizar automaticamente pacotes de atualização com vulnerabilidades conhecidas para versões fixas.

Avisos como erros

dotnet package update faz restaurações implícitas para verificar se o grafo de pacote resultante está livre de erros. Usar --vulnerable também faz uma restauração implícita para localizar avisos NuGetAudit. No entanto, se o projeto usa ou WarningsAsErrorsos avisos TreatWarningsAsErrors de restauração do NuGet podem causar falha na restauração, impedindo que a atualização seja concluída.

É recomendável aproveitar as condições do MSBuild e as variáveis de ambiente como uma solução alternativa até que essa solicitação de recurso seja implementada. Por exemplo, defina <TreatWarningsAsErrors Condition=" '$(CustomCondition)' == ''>true</TreatWarningsAsErrors> em seu projeto e, em seguida, na maioria dos shells linux e Mac, você pode executar CustomCondition=true dotnet package update. No Prompt de Comando do Windows e no PowerShell, você precisará definir a variável de ambiente, executar a atualização do pacote dotnet e desafixar a variável de ambiente como três comandos separados.

Arguments

• packages

  Uma lista opcional de pacotes a serem atualizados. Quando nenhum pacote for fornecido, o comando tentará atualizar todos os pacotes referenciados pelo projeto. Os pacotes podem ser um nome de pacote opcionalmente seguido por um @ e um número de versão. Por exemplo, dotnet package update Contoso.Utilities ou dotnet package update Contoso.Utilities@3.2.1. Quando nenhuma versão for fornecida, ela encontrará a versão mais alta disponível nas fontes de pacote configuradas.

Opções

• --interactive

  Permite que o comando pare e aguarde a entrada ou ação do usuário. Por exemplo, para concluir a autenticação.

• --project <path>

  O projeto no qual os pacotes devem ser atualizados. Se um diretório for fornecido, ele procurará arquivos de projeto e solução no diretório. O padrão é o diretório de trabalho atual.

• -v|--verbosity <LEVEL>

  Define o nível de verbosidade do comando. Os valores permitidos são q[uiet], m[inimal], n[ormal], d[etailed] e diag[nostic]. Para obter mais informações, consulte LoggerVerbosity.

• --vulnerable

  Se a restauração relatar quaisquer pacotes que tenham vulnerabilidades conhecidas, esse comando atualizará esses pacotes. Usar essa opção atualizará os pacotes para a versão mais baixa que é maior do que a versão referenciada no momento, que não tem nenhuma vulnerabilidade conhecida.

• -?|-h|--help

  Imprime uma descrição de como usar o comando.

Exemplos

• Atualizar todos os pacotes no projeto para a versão mais alta disponível

  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.
  

• Atualizar Contoso.Utilities para a versão mais alta disponível e Fabrikam.WebApi para a versão 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.
  

• Atualizar pacotes com vulnerabilidades conhecidas

  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.