Compartilhar via


comando update (CLI do NuGet)

Aplica-se a: consumo de pacotes • Versões suportadas: todas

Atualiza todos os pacotes de um projeto (usando packages.config) para as últimas versões disponíveis. É recomendável executar “restore” antes de executar update. (Para atualizar um pacote individual, use nuget install sem especificar um número de versão, caso em que o NuGet instala a versão mais recente.)

Nota: update não funciona com a CLI em execução no Mono (Mac OSX ou Linux) ou ao usar o formato PackageReference.

O comando update também atualiza as referências de assembly no arquivo de projeto, desde que essas referências já existam. Se um pacote atualizado tiver um assembly adicionado, uma nova referência não será adicionada. Novas dependências de pacote também não têm suas referências de assembly adicionadas. Para incluir essas operações como parte de uma atualização, atualize o pacote no Visual Studio usando a interface do usuário do Gerenciador de Pacotes ou o Console do Gerenciador de Pacotes.

Esse comando também pode ser usado para atualizar o próprio nuget.exe usando o sinalizador -self .

Uso

nuget update <configPath> [options]

em que <configPath> identifica uma packages.config ou um arquivo de solução que lista as dependências do projeto.

Opções

  • -ConfigFile

    O arquivo de configuração do NuGet a ser aplicado. Se não for especificado, %AppData%\NuGet\NuGet.Config (Windows), ~/.nuget/NuGet/NuGet.Config ou ~/.config/NuGet/NuGet.Config (Mac/Linux) será usado.

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

    Especifica a versão dos pacotes de dependência a serem usados, que pode ser uma das seguintes:

    • Mais baixa (padrão): a versão mais baixa
    • HighestPatch: a versão com o patch mais baixo maior, mais baixo maior, mais alto
    • HighestMinor: a versão com o patch mais alto, principal mais baixo, secundário mais alto
    • Mais alta: a versão mais alta
    • Ignorar: Nenhum pacote de dependência será usado

  • -FileConflictAction [PromptUser, Overwrite, Ignore]

    Especifica a ação padrão quando um arquivo de um pacote já existe no projeto de destino. Defina como Overwrite para sempre substituir arquivos. Defina como Ignore para ignorar arquivos.

    A ação PromptUser, o padrão, solicitará cada arquivo conflitante, a menos que OverwriteAllou IgnoreAll seja fornecido, o que se aplicará a todos os arquivos restantes.

  • -ForceEnglishOutput

    (3.5 ou superior) Força a execução de nuget.exe usando uma cultura invariável com base em inglês.

  • -?|-help

    Exibe as informações de ajuda para o comando.

  • -Id

    Especifica uma lista de IDs de pacote a serem atualizadas.

  • -MSBuildPath

    (4.0 ou superior) Especifica o caminho do MSBuild a ser usado com o comando, tendo precedência sobre -MSBuildVersion.

  • -MSBuildVersion

    (3.2 ou superior) Especifica a versão do MSBuild a ser usada com esse comando. Os valores suportados são 4, 12, 14, 15.1, 15.3, 15.4, 15.5, 15.6, 15.7, 15.8, 15.9. Por padrão, o MSBuild em seu caminho é selecionado, caso contrário, ele usa, por padrão, a versão mais recente instalada do MSBuild.

  • -NonInteractive

    Suprime solicitações de entrada de usuário ou confirmações.

  • -PreRelease

    Permite a atualização para versões de pré-lançamento. Esse sinalizador não é necessário ao atualizar pacotes de pré-lançamento que já estão instalados.

  • -RepositoryPath

    Especifica a pasta local na qual os pacotes estão instalados.

  • -Safe

    Especifica que somente as atualizações com a versão mais recente disponível na mesma versão principal e secundária do pacote instalado serão instaladas.

  • -Self

    Atualiza nuget.exe para a versão mais recente. -Source pode ser usado, no entanto, todos os outros argumentos são ignorados. Se nenhuma origem for fornecida, verificará em nuget.org se há atualizações, independentemente das configurações NuGet.Config.

  • -Source

    Especifica a lista de origens de pacote (como URLs) a serem usadas para as atualizações. Se omitido, o comando usará as fontes fornecidas nos arquivos de configuração, consulte Configurações comuns do NuGet.

  • -Verbosity [normal|quiet|detailed]

    Especifica a quantidade de detalhes exibida na saída: normal (o padrão), quiet ou detailed.

  • -Version

    Quando usado com uma ID de pacote, especifica a versão do pacote a ser atualizada.

Confira também Variáveis de ambiente

Exemplos

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