Visão geral do dotnetup

Note

dotnetup está em versão prévia pública. Seus recursos e comportamento podem mudar antes da disponibilidade geral.

dotnetupé um gerenciador de conjuntos de ferramentas multiplataforma para instalações de .NET no nível do usuário. Ele instala .NET SDKs e runtimes sem gravar em um diretório de .NET gerenciado pelo sistema. Ele também acompanha os requisitos de instalação selecionados para que ele possa atualizar ou remover os arquivos relacionados posteriormente.

Use dotnetup para:

  • Instale versões estáveis, prévias, diárias ou exatas do .NET.
  • Mantenha vários requisitos de SDK e runtime em uma instalação gerenciada.
  • Instale o SDK exigido pelo arquivo global.json mais próximo.
  • Atualize os canais rastreados sem alterar os requisitos de versão exata.
  • Configure como terminais e aplicativos encontram o dotnet gerenciado.
  • Execute o dotnet gerenciado sem alterar PATH.

Start

Execute a instalação interativa:

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: Terminal Mode (Suggested)

Would you like to install .NET with the recommended settings?
> Yes, proceed with defaults and install

Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>
Setup complete!

A configuração pergunta qual canal do SDK instalar e como você deseja acessar o comando dotnet gerenciado.

Para uma configuração concisa e nãointerativa, instale um SDK e configure o shell atual:

> dotnetup install latest
Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>

> dotnetup env set shell
dotnet and dotnetup are on your PATH.
To apply the change to this terminal now, run:
<shell-specific command>
Or open a new terminal.

> dotnetup list
Installations (managed by dotnetup):

  <default-installation-root>

    Tracked channels:
      SDK latest  (source: explicit)

    Installed versions:
      SDK <resolved-version>  (<architecture>)

Total: 1

> dotnet --version
<resolved-version>

Se você não quiser alterar o perfil do shell, use o comando de encaminhamento:

> dotnetup install latest
Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>

> dotnetup env set none
dotnetup is on your PATH. dotnet is not — run it with 'dotnetup dotnet <command>'.
Open a new terminal for the change to take effect.

> dotnetup dotnet --version
<resolved-version>

O modo, a versão resolvida, a arquitetura, o caminho de instalação e o comando do shell dependem do sistema e das versões disponíveis.

Como o dotnetup gerencia .NET

dotnetup rastreia as instalações do SDK solicitadas. Esse acompanhamento permite dotnetup atualizar muitas instalações ao mesmo tempo. Ele também permite dotnetup remover com segurança instalações não utilizadas ou fora de suporte.

Para obter mais informações, consulte Como o dotnetup funciona.

Objetivo Artigo
Decidir se o dotnetup se ajusta ao seu cenário Quando usar o dotnetup
Instale o dotnetup e execute a primeira configuração Primeiros passos com dotnetup
Entender canais, raízes de instalação e rastreamento Como funciona o dotnetup
Usar o global.json de um repositório Gerenciar requisitos do SDK do repositório
Instalar SDKs e runtimes Instalar componentes .NET
Atualizar ou remover instalações Atualizar instalações
Atualizar ou remover o dotnetup em si Atualizar ou remover dotnetup
Configurar PATH e DOTNET_ROOT Gerenciar o ambiente dotnetup
Experimente versões prévias ou builds diários Usar versões prévias e builds diários
Corrigir problemas comuns Solucionar problemas de dotnetup
Saiba quais dados o dotnetup coleta telemetria dotnetup
Pesquisar sintaxe de comando Referência de comando dotnetup

Availability

dotnetup está disponível como uma visualização pública. Comandos, opções e comportamento podem mudar entre versões prévias, e o ciclo de vida de suporte para a versão de disponibilidade geral não é final.

Para instalar dotnetup, consulte Introdução ao dotnetup. Depois de instalá-la, execute dotnetup --version para confirmar a versão e dotnetup --help ver os comandos disponíveis.

  • Última atualização em