Atualize instalações .NET controladas com dotnetup

Note

dotnetup está em pré-visualização pública. As suas funcionalidades e comportamento podem mudar antes da disponibilidade geral.

dotnetup armazena o canal solicitado separadamente da versão resolvida. Uma atualização resolve novamente cada canal de atualização em ciclos.

Escolha o escopo da atualização

Use um destes comandos:

# Update all tracked SDK and runtime requirements.
dotnetup update

# Update SDK requirements only.
dotnetup sdk update

# Update SDK and runtime requirements.
dotnetup sdk update --all

# Update runtime requirements only.
dotnetup runtime update

As atualizações em tempo de execução incluem os runtimes principais .NET e ASP.NET Core. No Windows, também incluem requisitos de runtime do Windows Desktop.

Limitar a raiz de instalação

Por predefinição, uma atualização pode processar requisitos para todos os projetos raiz no manifesto selecionado. Utilize --install-path para limitar a operação:

dotnetup update --install-path D:\tools\dotnet

Atualizar ficheiros de repositório

Os requisitos do SDK podem usar global.json como fonte. Para escrever a versão recém-resolvida do SDK em cada ficheiro fonte, execute:

dotnetup sdk update --update-global-json

Sem esta opção, o dotnetup instala a atualização mas não edita o ficheiro do repositório.

Uma atualização processa os requisitos armazenados antes de a recolha de lixo atualizar as fontes alteradas global.json. Depois de alterares o global.json de um repositório, executa dotnetup sdk install a partir desse repositório antes de atualizares os requisitos armazenados. Caso contrário, a primeira atualização pode ainda processar o requisito anterior.

Compreender o comportamento das atualizações

  • As versões exatas do SDK e do runtime são ignoradas – foram explicitamente solicitadas, por isso nunca podem ser atualizadas.
  • Cada requisito de instalação é processado de forma independente.
  • O processamento de todos os requisitos de instalação continua após uma falha individual.
  • O comando reporta a falha depois de processar todos os restantes requisitos de instalação.
  • As atualizações bem-sucedidas executam a recolha de lixo – um processo de limpeza que remove quaisquer componentes instalados de que nenhum dos requisitos de instalação configurados realmente necessita.
  • Mantém-se uma versão instalada caso outro requisito ainda precise dela.

Veja o resultado

Verifique o estado rastreado e as instalações no disco:

dotnetup list

Para saída legível por máquina:

dotnetup list --format json

Ver também

  • Última atualização a