Visão geral do dotnetup

Note

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

dotnetupé um gestor de cadeia de ferramentas multiplataforma para instalações .NET ao nível do utilizador. Instala SDKs e runtimes .NET sem gravar num diretório .NET gerido pelo sistema. Também regista os requisitos de instalação que selecionas para que possa atualizar ou remover os ficheiros relacionados mais tarde.

Use dotnetup para:

• Instala versões estáveis, de pré-visualização, diárias ou exatas do .NET.
• Mantenha múltiplos SDK e requisitos de tempo de execução numa única instalação gerida.
• Instala o SDK necessário para o ficheiro mais próximo global.json.
• Atualizar os canais rastreados sem alterar os requisitos de versão exata.
• Configure a forma como terminais e aplicações encontram o dotnet gerido.
• Execute o gerido dotnet sem alterar PATH.

Start

Execute a configuraçã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 o canal do SDK a instalar e como queres aceder ao comando gerido dotnet .

Para uma configuração concisa e não interativa, 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 não quiser alterar o perfil do seu 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 shell dependem do seu sistema e das versões disponíveis.

Como o dotnetup gere o .NET

dotnetup controla as instalações do SDK que solicita. Este acompanhamento permite dotnetup atualizar várias instalações ao mesmo tempo. Também permite dotnetup remover em segurança instalações não utilizadas ou fora de suporte.

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

Escolha o que ler a seguir

Goal	Artigo
Decida se o dotnetup se encaixa no teu cenário	Quando usar o dotnetup
Instala o dotnetup e executa a primeira configuração	Comece com o dotnetup
Compreender canais, diretórios de instalação e rastreamento	Como funciona o dotnetup
Usar o global.json de um repositório	Gerir 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 próprio dotnetup	Atualizar ou remover dotnetup
Configurar PATH e DOTNET_ROOT	Gerir o ambiente dotnetup
Experimente pré-visualizações ou compilações diárias	Use a pré-visualização e builds diárias
Corrigir problemas comuns	Resolução de problemas de dotnetup
Saiba quais os dados que o dotnetup recolhe	Telemetria dotnetup
Consultar a sintaxe dos comandos	Referência de comandos dotnetup

Availability

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

Para instalar dotnetup, veja Comece com dotnetup. Depois de o instalares, executa dotnetup --version para confirmar a versão e dotnetup --help para ver os comandos disponíveis.