Comece com 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, atualiza e remove .NET SDKs e runtimes sem usar um gerenciador de pacotes do sistema.

Prerequisites

  • Um dos seguintes sistemas operacionais e arquiteturas:

    Sistema operacional Architectures
    Windows x64, Arm64
    macOS x64, Arm64
    Linux (glibc) x64, Arm64
    Linux (musl), como o Alpine Linux x64, Arm64

  • Um terminal.

  • Bash no macOS ou Linux, ou PowerShell no Windows, para executar o script de download.

  • No macOS ou Linux, use curl ou wget para baixar arquivos e use sha512sum ou shasum para verificá-los.

dotnetuptem os mesmos requisitos do sistema operacional que o .NET Runtime. Para obter requisitos específicos do sistema operacional, consulte Instalar .NET em Windows, Instalar .NET no macOS ou instalar .NET no Linux.

Importante

No Windows, a configuração padrão usa o everywhere modo de acesso. Este modo:

  • Requer elevação para atualizar o sistema PATH.
  • Faz com que a instalação gerenciada por dotnetup tenha precedência sobre instalações de .NET em todo o computador, como as que o Visual Studio instala. Projetos e aplicativos que precisam de um SDK ou runtime em todo o computador que também não seja instalado por dotnetup falham na compilação ou execução.
  • Altera o sistema PATH, que se aplica a todos os usuários. Processos elevados iniciados por outros usuários podem resolver o .NET usando o seu perfil de usuário.

Para evitar esses efeitos, escolha o modo de acesso shell ou none durante a instalação. Se você escolher everywhere, migre suas instalações existentes quando o instalador oferecer. Para obter detalhes, consulte as considerações sobre o modo Everywhere.

Baixar dotnetup

Os scripts de download instalam o build mais recente preview por padrão. Eles verificam o executável baixado com sua soma de verificação SHA-512 e instalam-no em ~/.dotnetup.

No macOS ou Linux, execute:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

Em Windows, execute:

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

Para instalar o build mais recente daily no macOS ou linux, execute:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily

Para instalar o build mais recente daily no Windows, execute:

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily"

Importante

Os builds diários não concluíram a validação da release e não são assinados digitalmente. Use builds diários apenas para testes de curta duração.

Os scripts imprimem instruções para adicionar dotnetup a PATH. Abra um novo terminal depois de aplicar as instruções.

Executar a configuração inicial

Execute o assistente de configuração interativo:

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: <recommended-mode> (Suggested)

<recommended-mode> modifies <configuration-target> to set PATH and DOTNET_ROOT to prefer <install-path>.

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

Installing SDK <resolved-version> to <install-path>...
<download and installation progress>
Installed at <install-path>:
  SDK <resolved-version>
<mode-specific environment guidance>
Setup complete!

Os caminhos, a exibição de progresso e as diretrizes de ambiente dependem do sistema e do modo selecionado.

O modo de acesso recomendado é everywhere no Windows. No macOS e no Linux, é shell quando dotnetup detecta um shell com suporte e none , caso contrário.

Selecione Não, personalize a configuração para escolher o canal do SDK, o modo de acesso e as opções de migração.

Escolher um canal do SDK

Um canal do SDK informa dotnetup qual SDK instalar e como atualizá-lo.

Formulário do canal Example Result
Versão estável mais recente latest SDK estável ativo mais recente
LTS mais recente lts SDK LTS estável ativo mais recente
Versão prévia mais recente preview SDK de prévia mais recente
Última diária daily SDK diário mais recente disponível
Principal 10 SDK mais recente para a versão major especificada
Maior e menor 10.0 SDK mais recente para a versão principal e secundária especificada
Faixa de recursos 10.0.1xx SDK mais recente na faixa de recursos especificada
Versão exata 10.0.103 Somente a versão do SDK especificada
Nenhum SDK inicial none Ignorar a instalação durante a configuração

As versões exatas não avançam durante as atualizações. Para todas as formas aceitas, consulte canais e versões dotnetup.

Escolha como acessar .NET

O modo de acesso controla como terminais e aplicativos encontram a instalação .NET gerenciada por dotnetup.

Modo de acesso Behavior
none Não modifica essas variáveis de ambiente. Execute .NET com dotnetup dotnet.
shell Modifica o perfil do shell para definir essas variáveis de ambiente. Os processos iniciados a partir desse shell usam os SDKs e runtimes .NET instalados pelo dotnetup.
everywhere Modifica o sistema PATH e define a variável de ambiente DOTNET_ROOT no nível do usuário. Disponível somente em Windows.

Para obter mais detalhes e considerações para o modo everywhere, consulte a configuração do ambiente dotnetup.

Migrar instalações existentes

A instalação pode oferecer a migração de instalações existentes de .NET SDK e Runtime em todo o sistema para a instalação gerenciada por dotnetup. Consulte considerações sobre o modo Everywhere para saber por que a migração é especialmente importante no modo everywhere.

Verificar configuração

Abra um novo terminal após alterações na configuração do seu ambiente.

Para o modo shell ou everywhere, execute:

dotnet --version
dotnetup list

Para none o modo, execute:

dotnetup dotnet -- --version
dotnetup list

Execute dotnetup init novamente para alterar a configuração.

  • Última atualização em