Comece com o dotnetup

Note

dotnetup está em pré-visualização. 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, atualiza e remove SDKs e runtimes .NET sem usar um gestor de pacotes do sistema.

Prerequisites

  • Um dos seguintes sistemas operativos e arquiteturas:

    Sistema Operativo 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 no PowerShell no Windows, para executar o script de download.

  • No macOS ou Linux, curl ou wget para descarregar ficheiros, e sha512sum /ou shasum para os verificar.

dotnetup tem os mesmos requisitos de sistema operativo que o .NET Runtime. Para requisitos específicos do sistema operativo, veja Instalar .NET no 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 gerida pelo dotnetup tenha prioridade sobre as instalações .NET em toda a máquina, como as que o Visual Studio instala. Projetos e aplicações que precisam de um SDK ou runtime para toda a máquina que não seja também instalado por dotnetup falham ao compilar ou executar.
  • Altera o sistema PATH, que se aplica a todos os utilizadores. Processos elevados iniciados por outros utilizadores podem carregar o .NET a partir do teu perfil de utilizador.

Para evitar estes efeitos, escolha o modo de acesso none ou shell durante a configuração. Se escolheres everywhere, migra as tuas instalações existentes quando a configuração o oferecer. Para mais detalhes, veja considerações sobre o modo Em todo o lado.

Descarregar dotnetup

Os scripts de download instalam a build mais recente preview por defeito. Verificam o executável descarregado com o seu checksum SHA-512 e instalam-no em ~/.dotnetup.

No macOS ou Linux, execute:

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

No sistema Windows, execute o seguinte:

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

Para instalar a versão mais recente daily no macOS ou Linux, execute:

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

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

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

Importante

As compilações diárias ainda não completaram a validação de lançamento e não são assinadas digitalmente. Usa builds diárias 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, o ecrã de progresso e as orientações do ambiente dependem do seu sistema e do modo selecionado.

O modo de acesso recomendado é everywhere no Windows. No macOS e Linux, é shell quando dotnetup deteta uma shell suportada e none caso contrário.

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

Escolha um canal SDK

Um canal de SDK indica dotnetup qual o SDK a instalar e como o atualizar.

Formulário do canal Example Result
Versão estável mais recente latest Versão mais recente do SDK estável ativo
LTS mais recente lts Mais recente LTS SDK estável ativo
Última pré-visualização preview SDK de pré-visualização mais recente
Mais recente diária daily SDK diário mais recente disponível
Maior 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
Banda de funcionalidade 10.0.1xx SDK mais recente na faixa de funcionalidades especificada
Versão exata 10.0.103 Apenas a versão especificada do SDK
Sem SDK inicial none Ignorar a instalação durante a configuração

As versões exatas não são atualizadas durante as atualizações. Para todas as formas aceites, consulte canais e versões dotnetup.

Escolha como aceder ao .NET

O modo de acesso controla como terminais e aplicações encontram a instalação .NET gerida pelo dotnetup.

Modo de acesso Comportamento
none Não modifica estas variáveis de ambiente. Execute o .NET com dotnetup dotnet.
shell Modifica o perfil do shell para definir estas variáveis de ambiente. Os processos iniciados a partir desse shell usam os SDKs .NET e os Runtimes instalados pelo dotnetup.
everywhere Modifica o sistema PATH e define a variável de ambiente ao nível DOTNET_ROOT do utilizador. Disponível apenas no Windows.

Para mais detalhes e considerações sobre everywhere o modo, veja configuração do ambiente dotnetup.

Migrar instalações existentes

O Setup pode oferecer a migração de instalações existentes do .NET SDK e Runtime ao nível da máquina para a instalação gerida pelo dotnetup. Consulte as considerações do modo Everywhere para perceber por que razão a migração é especialmente importante com o everywhere modo.

Verificar configuração

Abra um novo terminal depois de a configuração alterar o seu ambiente.

Para o modo shell ou everywhere, execute:

dotnet --version
dotnetup list

Para o modo none, execute:

dotnetup dotnet -- --version
dotnetup list

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

  • Última atualização a