Compartilhar via

Instalar o runtime do .NET com Snap

  • Artigo

Este artigo descreve como instalar o pacote Snap do runtime do .NET. Os pacotes Snap do runtime 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.

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 recebem suporte e patches gratuitos por 18 meses. 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:

  • 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 liberam o .NET podem introduzir políticas de suporte diferentes. Certifique-se de verificar com elas para entender como o .NET possui suporte.

1. Instale o runtime

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 específica do Linux os inclua.

As etapas a seguir instalam o pacote snap de runtime do .NET 9:

  1. Abra um terminal.

  2. Use snap install para instalar o pacote Snap do runtime do .NET. Por exemplo, o comando a seguir instala o runtime do .NET 8.

    sudo snap install dotnet-runtime-80

Cada runtime do .NET é publicado como um pacote Snap individual. A seguinte tabela lista os pacotes:

Versão do .NET Pacote do Snap Versão do .NET com suporte da Microsoft
9 (STS) Ainda não disponível Sim
8 (LTS) dotnet-runtime-80 Sim
7 (STS) dotnet-runtime-70 Não
6 (LTS) dotnet-runtime-60 Não
5 dotnet-runtime-50 Não
3.1 dotnet-runtime-31 Não
3.0 dotnet-runtime-30 Não
2.2 dotnet-runtime-22 Não
2.1 dotnet-runtime-21 Não

2. Habilitar o comando dotnet

Quando o pacote Snap do runtime do .NET é instalado, o comando dotnet não é configurado automaticamente. Use o comando snap alias para usar o comando dotnet do terminal. O comando é formatado como: sudo snap alias {package}.{command} {alias}. O exemplo a seguir mapeia o comando dotnet:

sudo snap alias dotnet-runtime-90.dotnet dotnet

3. 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. Por exemplo, se você instalou o Snap dotnet-runtime-90, use o seguinte comando para definir a variável de ambiente para onde o .NET está localizado:

export DOTNET_ROOT=/snap/dotnet-runtime-90/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:

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

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

Solução de problemas

O comando dotnet de terminal não funciona

Os pacotes Snap podem mapear um alias para um comando fornecido pelo pacote. Os pacotes Snap do runtime do .NET não vinculam automaticamente o comando dotnet. Para vincular o comando dotnet ao pacote Snap, use o seguinte comando:

sudo snap alias dotnet-runtime-90.dotnet dotnet

Substitua dotnet-runtime-90 pelo nome do pacote de runtime.

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.

4. Usar a CLI do .NET

Abra um terminal e digite dotnet.

dotnet

Você verá uma saída semelhante ao seguinte:

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.

Conteúdo relacionado