Partilhar via

Instalar o SDK do .NET com o Snap

  • Artigo

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

Um snap é um pacote de um aplicativo e suas dependências que funciona em muitas distribuições Linux diferentes. Os snaps podem ser descobertos e instalados a partir da Snap Store. Para obter mais informações sobre o Snap, consulte Tour de início rápido.

Atenção

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

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

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

Pré-requisitos

  • Distribuição Linux que suporta snap.
  • snapd o daemon snap.

Sua distribuição Linux já pode incluir snap. Tente executar snap a partir de um terminal para ver se o comando funciona. Para obter uma lista de distribuições Linux suportadas e instruções sobre como instalar o snap, consulte Instalando snapdo .

Versões do .NET

A Microsoft publica o .NET em duas políticas de suporte diferentes, Suporte de Longo Prazo (LTS) e Suporte de Prazo Padrão (STS). A qualidade de todos os lançamentos é a mesma. A única diferença é a duração do apoio. As versões LTS recebem suporte e patches gratuitos por três anos. As versões STS recebem suporte e patches gratuitos por 18 meses. Para obter mais informações, consulte Política de suporte do .NET.

As versões do .NET que são atualmente suportadas pela Microsoft são:

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

Outras entidades que criam e lançam o .NET podem introduzir políticas de suporte diferentes. Certifique-se de verificar com eles para entender como o .NET é suportado.

1. Instale o SDK

Importante

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

Os pacotes de ajuste para o SDK do .NET são todos publicados sob o mesmo identificador: dotnet-sdk. Uma versão específica do SDK pode ser instalada especificando o canal. O SDK inclui o tempo de execução do ASP.NET Core e do .NET, versionado para o SDK.

Gorjeta

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

  1. Abra um terminal.

  2. Use snap install para instalar o pacote de snap do SDK do .NET. Por exemplo, o comando a seguir instala o latest/stable canal, que é o padrão.

    sudo snap install dotnet-sdk --classic
    • O parâmetro --classic é necessário.
    • Use o --channel parâmetro para especificar qual versão instalar. Se este parâmetro for omitido, latest/stable é usado. Por exemplo, --channel 8.0/stable instala o .NET SDK 8.0.

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

A tabela a seguir lista os canais de pacote que você pode instalar:

Versão .NET Canal do pacote Snap
9 (STS) *Ainda não disponível
8 (LTS) 8.0/stable
lts/stable
7 (STS) 7.0/stable (sem apoio)
6 (LTS) 6.0/stable (sem apoio)
5 5.0/stable (sem apoio)
3.1 3.1/stable (sem apoio)
2.1 2.1/stable (sem apoio)

2. Exporte o local de instalação

A DOTNET_ROOT variável de ambiente é frequentemente 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.

export DOTNET_ROOT=/snap/dotnet-sdk/current

Exportar a variável de ambiente permanentemente

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

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

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

Edite o arquivo de origem apropriado para seu shell e adicione export DOTNET_ROOT=/snap/dotnet-sdk/current.

3. Use a CLI do .NET

Abra um terminal e digite dotnet.

dotnet

A seguinte saída é exibida:

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, consulte Visão geral da CLI do .NET.

Resolução de Problemas

O comando dotnet terminal não funciona

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

sudo snap alias dotnet-sdk.dotnet dotnet

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

systemd deve estar habilitado na instância 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. Utilize o comando wsl.exe --shutdown.

Não é possível resolver o comando dotnet ou 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 DOTNET_ROOT variável de ambiente ou descobrindo onde o dotnet executável está localizado. Um SDK do .NET instalado em 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
  • Não foi possível encontrar o SDK 'Microsoft.NET.Sdk.Web' especificado
  • O SDK 'Microsoft.NET.Sdk.Razor' especificado não pôde ser encontrado

Tente as seguintes etapas para corrigir o problema:

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

  2. Tente vincular simbolicamente o executável de snap dotnet ao local que o programa está procurando.

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

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

    Use o seguinte comando para criar um link simbólico para o pacote de ajuste:

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

Erros de certificado TLS/SSL

Quando o .NET é instalado através 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

A localização do certificado varia de acordo com a distribuição. Aqui estão os locais para as distribuições onde 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údos relacionados