Instalar manualmente o SDK do .NET ou o Runtime do .NET

O .NET tem suporte no Linux e este artigo descreve como instalar o .NET no Linux usando o script de instalação ou extraindo os binários. Para ver uma lista de distribuições que suportam o gerenciador de pacotes integrado, consulte Instalar o .NET no Linux.

Você também pode instalar o .NET com o snap. Para obter mais informações, consulte Instalar o SDK do .NET ou o Runtime do .NET com o Snap.

Instale o SDK (que inclui o tempo de execução) se você quiser desenvolver aplicativos .NET. Ou, se você só precisa executar aplicativos, instale o tempo de execução. Se você estiver instalando o tempo de execução, sugerimos que instale o ASP.NET Core Runtime , pois ele inclui .net e ASP.NET Core Runtimes.

Se você já tiver instalado o SDK ou tempo de execução, use os dotnet --list-sdks dotnet --list-runtimes comandos e para ver quais versões estão instaladas. Para obter mais informações, consulte como verificar se o .net já está instalado.

Versões do .NET

A tabela a seguir lista as versões do .NET (e do .NET Core) :

✔️ Com suporte ❌ Unsupported
6 (LTS) 3.0
5 2.2
3.1 (LTS) 2.1
2,0
1,1
1.0

Para obter mais informações sobre o ciclo de vida de versões do .NET, consulte Política de suporte do .NET e do .NET Core.

Dependências

É possível que, ao instalar o .NET, dependências específicas não possam ser instaladas, como ao instalar manualmente o. A lista a seguir fornece detalhes sobre as distribuições do Linux com suporte da Microsoft e com dependências que talvez você precise instalar. Verifique a página de distribuição para obter mais informações:

Para obter informações genéricas sobre as dependências, consulte Aplicativos Linux autossu contidos.

Dependências rpm

Se sua distribuição não foi listada anteriormente e é baseada em RPM, talvez você precise das seguintes dependências:

  • krb5-libs
  • libicu
  • openssl-libs

Se a versão do OpenSSL do ambiente de runtime de destino for 1.1 ou mais recente, você precisará instalar o compat-openssl10.

Dependências DEB

Se sua distribuição não foi listada anteriormente e é baseada em debian, talvez você precise das seguintes dependências:

  • libc6
  • libgcc1
  • libgssapi-krb5-2
  • libicu67
  • libssl1.1
  • libstdc++6
  • zlib1g

Dependências comuns

Para aplicativos .NET que usam o assembly System.Drawing.Common, você também precisará da seguinte dependência:

Instalação com script

Os scripts dotnet-install são usados para automação e instalação não administrativa do SDK e runtime. É possível baixar o script em https://dot.net/v1/dotnet-install.sh.

Importante

O Bash é necessário para executar o script.

O script assume como padrão a instalação da versão mais recente do LTS (suporte a longo prazo) do SDK, que é o .NET 6. Para instalar a versão atual, que pode não ser uma versão (LTS), use o -c Current parâmetro .

./dotnet-install.sh -c Current

Para instalar o Runtime do .NET em vez do SDK, use o --runtime parâmetro .

./dotnet-install.sh -c Current --runtime aspnetcore

Você pode instalar uma versão específica alterando o -c parâmetro para indicar a versão específica. O comando a seguir instala o SDK do .NET 6.0.

./dotnet-install.sh -c 6.0

Para obter mais informações, consulte referência de scripts dotnet-install.

Instalação manual

Como alternativa aos gerenciadores de pacotes, você pode baixar e instalar manualmente o SDK e o runtime. A instalação manual normalmente é usada como parte do teste de integração contínua ou em uma distribuição do Linux sem suporte. Para um desenvolvedor ou usuário, é melhor usar um gerenciador de pacotes.

Primeiro, baixe uma versão binária para o SDK ou o runtime de um dos sites a seguir. Se você instalar o SDK do .NET, não será necessário instalar o runtime correspondente:

Em seguida, extraia o arquivo baixado e use o comando para definir para o local da pasta extraída e, em seguida, verifique se export DOTNET_ROOT o .NET está em PATH. Isso deve disponibilizar os comandos da CLI do .NET no terminal.

Como alternativa, depois de baixar o binário do .NET, os comandos a seguir podem ser executados no diretório em que o arquivo é salvo para extrair o runtime. Isso também disponibiliza os comandos da CLI do .NET no terminal e definirá as variáveis de ambiente necessárias. Lembre-se de DOTNET_FILE alterar o valor para o nome do binário baixado:

DOTNET_FILE=dotnet-sdk-6.0.100-linux-x64.tar.gz
export DOTNET_ROOT=$(pwd)/dotnet

mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT"

export PATH=$PATH:$DOTNET_ROOT

Dica

Os comandos anteriores export disponibilizam apenas os comandos da CLI do .NET para a sessão de terminal na qual ela foi executado.

Você pode editar seu perfil de shell para adicionar permanentemente os comandos. Há vários shells diferentes disponíveis para Linux e cada um tem um perfil diferente. Por exemplo:

  • Shell bash: ~/.bash_profile, ~/.bashrc
  • Korn Shell: ~/.kshrc ou .profile
  • Shell Z: ~/.zshrc ou .zprofile

Edite o arquivo de origem apropriado para o shell e :$HOME/.dotnet adicione ao final da instrução PATH existente. Se nenhuma PATH instrução for incluída, adicione uma nova linha com export PATH=$PATH:$HOME/.dotnet .

Além disso, export DOTNET_ROOT=$HOME/.dotnet adicione ao final do arquivo.

Essa abordagem permite que você instale versões diferentes em locais separados e escolha explicitamente qual delas usar por qual aplicativo.

Próximas etapas