Compartilhar via

Instalar o SDK do .NET com o Snap

Este artigo descreve como instalar o pacote Snap do SDK do .NET. Os pacotes snap do SDK do .NET são fornecidos e mantidos pela Canonical. Os snaps são uma ótima alternativa para o gerenciador de pacotes integrado à distribuição do Linux.

Um snap é um pacote de um aplicativo e as dependências dele que funcionam em muitas distribuições diferentes do Linux. Os snaps são detectáveis e instaláveis no Snap Store. Para saber mais sobre o Snap, consulte o Tour de Início Rápido.

Cuidado

Instalações de ajuste do .NET podem ter problemas ao executar as ferramentas do .NET. Se você quiser usar ferramentas do .NET, recomendamos que instale o .NET usando o dotnet-install script ou o gerenciador de pacotes para a distribuição específica do Linux.

É um problema conhecido que o comando dotnet watch não funciona quando o .NET é instalado por meio do Snap.

Se você pretende usar as ferramentas do .NET ou o comando dotnet watch, recomendamos que você instale o .NET usando o dotnet-install script.

Pré-requisitos

  • Distribuição do Linux que dá suporte a snap.
  • snapd o daemon snap.

Sua distribuição do Linux já pode incluir snap. Tente executar snap em um terminal para ver se o comando funciona. Para obter uma lista de distribuições do Linux com suporte e instruções sobre como instalar o snap, consulte Instalar o snapd.

Versões do .NET

A Microsoft publica o .NET em duas políticas de suporte diferentes, LTS (Suporte de Longo Prazo) e STS (Suporte de Prazo Padrão). A qualidade de todas as versões é a mesma. A única diferença é a duração do suporte. As versões LTS recebem suporte e patches gratuitos por três anos. As versões STS ganham suporte gratuito e patches por dois anos. Para obter mais informações, confira a Política de Suporte do .NET.

As versões do .NET que têm suporte atualmente pela Microsoft são:

  • 10.0 (LTS)— O suporte termina em 14 de novembro de 2028.
  • 9.0 (STS)— O suporte termina em 10 de novembro de 2026.
  • 8.0 (LTS)— O suporte termina em 10 de novembro de 2026.

Outras entidades que criam e liberam o .NET podem introduzir políticas de suporte diferentes. Certifique-se de verificar com elas para entender como o .NET possui suporte.

1. Instalar o SDK

Importante

O .NET 10 foi lançado em 11 de novembro de 2025. Pode levar algum tempo para que os pacotes apareçam nos feeds do gerenciador de pacotes ou para que sua distribuição específica do Linux os inclua.

A partir do .NET 9, os pacotes snap para o SDK do .NET são publicados em identificadores específicos da versão (por exemplo, dotnet-sdk-90 para .NET 9 e dotnet-sdk-100 para .NET 10). Antes do .NET 9, todas as versões do SDK eram publicadas no mesmo identificador dotnet-sdke você especificou a versão por meio de um canal. Além disso, os pacotes snap do .NET 9 e posteriores dão suporte a arquiteturas x64 e Arm64, enquanto as versões anteriores dão suporte apenas ao x64. O SDK inclui o runtime do ASP.NET Core e do .NET, com versão para o SDK.

Dica

A página de pacotes do SDK Snapcraft .NET inclui instruções específicas para distribuição sobre como instalar o Snapcraft e o .NET.

  1. Abra um terminal.

  2. Use snap install para instalar o pacote Snap do SDK do .NET.

    O --classic parâmetro é obrigatório.

    • Para .NET 9 e posterior

      Instale o pacote específico à versão. Por exemplo, o comando a seguir instala o SDK do .NET 10:

      sudo snap install dotnet-sdk-100 --classic

    • Para .NET 8 e anterior

      Instale o pacote dotnet-sdk e especifique um canal. Se esse parâmetro for omitido, latest/stable será usado. Por exemplo, o seguinte comando instala o SDK do .NET 8:

      sudo snap install dotnet-sdk --classic --channel 8.0/stable

O alias do Snap dotnet é criado automaticamente e mapeado para o comando dotnet do pacote Snap.

A tabela a seguir lista os pacotes snap e os canais que você pode instalar:

Versão do .NET Pacote Snap ou canal
10 (LTS) dotnet-sdk-100 (versão Preliminar)
9 (STS) dotnet-sdk-90
8 (LTS) dotnet-sdk --channel 8.0/stable
7 dotnet-sdk --channel 7.0/stable (sem suporte)
6 dotnet-sdk --channel 6.0/stable (sem suporte)
5 dotnet-sdk --channel 5.0/stable (sem suporte)
3.1 dotnet-sdk --channel 3.1/stable (sem suporte)
2.1 dotnet-sdk --channel 2.1/stable (sem suporte)

2. Exportar o local de instalação

A variável de ambiente DOTNET_ROOT geralmente é usada por ferramentas para determinar onde o .NET está instalado. Quando o .NET é instalado por meio do Snap, essa variável de ambiente não é configurada. Você deve configurar a variável de ambiente DOTNET_ROOT em seu perfil. O caminho para o Snap usa o seguinte formato: /snap/{package}/current.

Para o .NET 9 e versões posteriores, utilize o nome do pacote específico para a versão:

export DOTNET_ROOT=/snap/dotnet-sdk-100/current

Para .NET 8 e anterior, use o nome do pacote compartilhado:

export DOTNET_ROOT=/snap/dotnet-sdk/current

Exportar a variável de ambiente permanentemente

O comando export anterior define apenas a variável de ambiente da sessão de terminal em que foi executada.

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

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

Edite o arquivo de origem apropriado para o shell e adicione o comando de exportação para sua versão do .NET instalada. Para .NET 9+, use export DOTNET_ROOT=/snap/dotnet-sdk-100/current (ajuste o número de versão conforme necessário). Para .NET 8 e anterior, use export DOTNET_ROOT=/snap/dotnet-sdk/current.

3. Usar a CLI do .NET

Abra um terminal e digite dotnet.

dotnet

É exibida a saída a seguir:

Usage: dotnet [options]
Usage: dotnet [path-to-application]

Options:
  -h|--help         Display help.
  --info            Display .NET information.
  --list-sdks       Display the installed SDKs.
  --list-runtimes   Display the installed runtimes.

path-to-application:
  The path to an application .dll file to execute.

Para saber como usar a CLI do .NET, confira Visão geral da CLI do .NET.

Solução de problemas

O comando do terminal dotnet não funciona

Os pacotes Snap podem mapear um alias para um comando fornecido pelo pacote. Por padrão, os pacotes Snap do SDK do .NET criam um alias para o comando dotnet. Se o alias não foi criado ou foi removido anteriormente, use o comando a seguir para mapear o alias.

Para .NET 9 e posterior:

sudo snap alias dotnet-sdk-100.dotnet dotnet

Para .NET 8 e anterior:

sudo snap alias dotnet-sdk.dotnet dotnet

Não é possível instalar o Snap no WSL2

systemd deve ser habilitado na instância do WSL2 antes que o Snap possa ser instalado.

  1. Abra /etc/wsl.conf em um editor de texto de sua escolha.

  2. Cole na seguinte configuração:

    [boot]
systemd=true

  3. Salve o arquivo e reinicie a instância do WSL2 por meio do PowerShell. Use o comando wsl.exe --shutdown.

Não é possível resolver o comando dotnet ou o SDK

É comum que outros aplicativos, como um IDE de código ou uma extensão no Visual Studio Code, tentem resolver o local do SDK do .NET. Normalmente, a descoberta é feita verificando a variável de ambiente DOTNET_ROOT ou descobrindo onde o executável dotnet está localizado. Um SDK do .NET instalado pelo Snap pode confundir esses aplicativos. Quando esses aplicativos não conseguem resolver o SDK do .NET, um erro semelhante a uma das seguintes mensagens é exibido:

  • Não foi possível encontrar o SDK "Microsoft.NET.Sdk" especificado
  • Não foi possível encontrar o SDK "Microsoft.NET.Sdk.Web" especificado
  • Não foi possível encontrar o SDK "Microsoft.NET.Sdk.Razor" especificado

Experimente as seguintes etapas para corrigir o problema:

  1. Certifique-se de exportar permanentemente a variável de ambiente DOTNET_ROOT.

  2. Tente vincular o executável dotnet do Snap ao local que o programa está procurando.

    Dois caminhos comuns que o comando dotnet está procurando são:

    • /usr/local/bin/dotnet
    • /usr/share/dotnet

    Use o comando a seguir para criar um link simbólico para o pacote snap. Para o .NET 9 e versões posteriores, use o nome do pacote específico de versão:

    ln -s /snap/dotnet-sdk-100/current/dotnet /usr/local/bin/dotnet

    Para .NET 8 e anterior:

    ln -s /snap/dotnet-sdk/current/dotnet /usr/local/bin/dotnet

Erros de certificado TLS/SSL

Quando o .NET é instalado por meio do Snap, é possível que, em algumas distribuições, os certificados TLS/SSL do .NET não sejam encontrados e você possa receber um erro durante restore:

Processing post-creation actions...
Running 'dotnet restore' on /home/myhome/test/test.csproj...
  Restoring packages for /home/myhome/test/test.csproj...
/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error : Unable to load the service index for source https://api.nuget.org/v3/index.json. [/home/myhome/test/test.csproj]
/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error :   The SSL connection could not be established, see inner exception. [/home/myhome/test/test.csproj]
/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error :   The remote certificate is invalid according to the validation procedure. [/home/myhome/test/test.csproj]

Para resolver esse problema, defina algumas variáveis de ambiente:

export SSL_CERT_FILE=[path-to-certificate-file]
export SSL_CERT_DIR=/dev/null

O local do certificado varia de acordo com a distribuição. Estes estão os locais para as distribuições em que o problema foi observado:

Distribuição Location
Fedora /etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem
OpenSUSE /etc/ssl/ca-bundle.pem
Solus /etc/ssl/certs/ca-certificates.crt

Conteúdo relacionado

  • Last updated on