Compartilhar via

Instalar .NET SDK com Snap

Este artigo descreve como instalar o pacote snap do SDK .NET. Os pacotes SDK snap 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 Snap do .NET podem ter problemas ao executar ferramentas .NET. Se você quiser usar .NET ferramentas, recomendamos instalar .NET usando o script dotnet-install 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 .NET é instalado por meio do Snap.

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

Pré-requisitos

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

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.

.NET lançamentos

A Microsoft publica .NET em duas políticas de suporte diferentes, LTS (Suporte de Longo Prazo) e STS (Suporte a Termos 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, consulte .NET Support Policy.

As versões de .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 .NET podem introduzir políticas de suporte diferentes. Certifique-se de verificar com eles para entender como há suporte para .NET.

1. Instalar o SDK

Importante

.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-sdk e você especificou a versão por meio de um canal. Além disso, os pacotes snap do .NET 9 e posteriores suportam as arquiteturas x64 e Arm64, enquanto as versões anteriores suportam apenas x64. O SDK inclui tanto o ASP.NET Core quanto o .NET runtime, ambos versionados de acordo com o SDK.

Dica

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

  1. Abra um terminal.

  2. Use snap install para instalar o pacote snap do SDK .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 .NET SDK 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 comando a seguir instala .NET SDK 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:

.NET versão 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 .NET está instalado. Quando .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 .NET 9 e versões posteriores, use o nome específico de pacote da versão:

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

Para .NET 8 e anteriores, 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 a versão .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 anteriores, 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 .NET, consulte .NET visão geral da CLI.

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 .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 posteriores:

sudo snap alias dotnet-sdk-100.dotnet dotnet

Para .NET 8 e anteriores:

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. Insira na configuração a seguir:

    [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 em 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 de .NET instalado por 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:

  • O SDK 'Microsoft.NET.Sdk' especificado não pôde ser encontrado.
  • O SDK 'Microsoft.NET.Sdk.Web' especificado não pôde ser encontrado
  • O SDK 'Microsoft.NET.Sdk.Razor' especificado não pôde ser encontrado.

Experimente as seguintes etapas para corrigir o problema:

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

  2. Tente criar um link simbólico do executável dotnet 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 .NET 9 e versões posteriores, use o nome específico de pacote da versão:

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

    Para .NET 8 e anteriores:

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

Erros de certificado TLS/SSL

Quando .NET é instalado por meio do Snap, é possível que, em algumas distribuições, os certificados .NET TLS/SSL 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 Localização
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