Instalar .NET no Debian - .NET (2023)

Este artigo descreve como instalar o .NET no Debian. Quando uma versão do Debian deixa de ser compatível, o .NET não é mais compatível com essa versão. No entanto, essas instruções podem ajudá-lo a executar o .NET nessas versões, mesmo que não haja suporte.

Instale o SDK (que inclui o tempo de execução) se desejar desenvolver aplicativos .NET. Ou, se você precisar apenas executar aplicativos, instale o Runtime. Se você estiver instalando o Runtime, sugerimos que instale oTempo de execução do ASP.NET Corepois inclui tempos de execução .NET e ASP.NET Core.

Use odotnet --list-sdksedotnet --list-runtimescomandos para ver quais versões estão instaladas. Para mais informações, vejaComo verificar se o .NET já está instalado.

Para obter mais informações sobre a instalação do .NETsem um gerenciador de pacotes, consulte um dos seguintes artigos:

• Como alternativa, instale o .NET com o script install-dotnet.
• Instalar manualmente o .NET

Distribuições suportadas

A tabela a seguir é uma lista dos lançamentos .NET atualmente suportados e as versões do Debian nas quais eles são suportados. Essas versões permanecem suportadas até que a versão do.NET atinge o fim do suporteou a versão deDebian chega ao fim da vida.

As seguintes versões do .NET ❌ não são mais suportadas:

• .NET 5
• .NET Núcleo 3.1
• .NET Core 3.0
• .NET Core 2.2
• .NET Núcleo 2.1
• .NET Core 2.0

Instalar versões de visualização

Versões pré-visualizadas e candidatas a lançamento do .NET não estão disponíveis em repositórios de pacotes. Você pode instalar pré-visualizações e candidatos a lançamento do .NET de uma das seguintes maneiras:

• Instalação com script com install-dotnet.sh
• Extração binária manual

Remover versões de visualização

Ao usar um gerenciador de pacotes para gerenciar sua instalação do .NET, você pode entrar em conflito se tiver instalado anteriormente uma versão de visualização. O gerenciador de pacotes pode interpretar a versão não prévia como uma versão anterior do .NET. Para instalar a versão sem visualização, primeiro desinstale as versões de visualização. Para obter mais informações sobre como desinstalar o .NET, consulteComo remover o .NET Runtime e o SDK.

Debian 11

A instalação com o APT pode ser feita com alguns comandos. Antes de instalar o .NET, execute os seguintes comandos para adicionar a chave de assinatura do pacote Microsoft à sua lista de chaves confiáveis ​​e adicione o repositório de pacotes.

Abra um terminal e execute os seguintes comandos:

wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.debsudo dpkg -i packages-microsoft-prod.debrm packages-microsoft-prod.deb

Instale o SDK

O SDK .NET permite que você desenvolva aplicativos com .NET. Se você instalar o .NET SDK, não precisará instalar o tempo de execução correspondente. Para instalar o .NET SDK, execute os seguintes comandos:

sudo apt-get update && \ sudo apt-get install -y dotnet-sdk-7.0

Instale o tempo de execução

O ASP.NET Core Runtime permite executar aplicativos criados com .NET que não fornecem o tempo de execução. Os comandos a seguir instalam o ASP.NET Core Runtime, que é o tempo de execução mais compatível para .NET. No seu terminal, execute os seguintes comandos:

sudo apt-get update && \ sudo apt-get install -y aspnetcore-runtime-7.0

Como alternativa ao ASP.NET Core Runtime, você pode instalar o .NET Runtime, que não inclui suporte para ASP.NET Core: substituaaspnetcore-runtime-7.0no comando anterior comdotnet-runtime-7.0:

sudo apt-get install -y dotnet-runtime-7.0

Debian 10

A instalação com o APT pode ser feita com alguns comandos. Antes de instalar o .NET, execute os seguintes comandos para adicionar a chave de assinatura do pacote Microsoft à sua lista de chaves confiáveis ​​e adicione o repositório de pacotes.

Abra um terminal e execute os seguintes comandos:

wget https://packages.microsoft.com/config/debian/10/packages-microsoft-prod.deb -O packages-microsoft-prod.debsudo dpkg -i packages-microsoft-prod.debrm packages-microsoft-prod.deb

Instale o SDK

O SDK .NET permite que você desenvolva aplicativos com .NET. Se você instalar o .NET SDK, não precisará instalar o tempo de execução correspondente. Para instalar o .NET SDK, execute os seguintes comandos:

sudo apt-get update && \ sudo apt-get install -y dotnet-sdk-7.0

Instale o tempo de execução

O ASP.NET Core Runtime permite executar aplicativos criados com .NET que não fornecem o tempo de execução. Os comandos a seguir instalam o ASP.NET Core Runtime, que é o tempo de execução mais compatível para .NET. No seu terminal, execute os seguintes comandos:

sudo apt-get update && \ sudo apt-get install -y aspnetcore-runtime-7.0

Como alternativa ao ASP.NET Core Runtime, você pode instalar o .NET Runtime, que não inclui suporte para ASP.NET Core: substituaaspnetcore-runtime-7.0no comando anterior comdotnet-runtime-7.0:

sudo apt-get install -y dotnet-runtime-7.0

Como instalar outras versões

Todas as versões do .NET estão disponíveis para download emhttps://dotnet.microsoft.com/download/dotnet, mas requerinstalação manual. Você pode tentar usar o gerenciador de pacotes para instalar uma versão diferente do .NET. No entanto, a versão solicitada pode não estar disponível.

Os pacotes adicionados aos feeds do gerenciador de pacotes são nomeados em um formato que pode ser hackeado, por exemplo:{produto}-{tipo}-{versão}.

• produtos
  O tipo de produto .NET a ser instalado. As opções válidas são:

  • ponto Net
  • aspnetcore

• tipo
  Escolhe o SDK ou o tempo de execução. As opções válidas são:

  • SDK (disponível apenas para oponto Netprodutos)
  • tempo de execução

• versão
  A versão do SDK ou tempo de execução a ser instalado. Este artigo sempre fornecerá as instruções para a versão suportada mais recente. As opções válidas são qualquer versão lançada, como:

  • 7,0
  • 5,0
  • 3.1
  • 2.1

  É possível que o SDK/tempo de execução que você está tentando baixar não esteja disponível para sua distribuição Linux. Para obter uma lista de distribuições suportadas, consulteInstalar .NET no Linux.

Exemplos

• Instale o tempo de execução do ASP.NET Core 7.0:aspnetcore-runtime-7.0
• Instale o tempo de execução do .NET Core 2.1:dotnet-runtime-2.1
• Instale o SDK do .NET 5:dotnet-sdk-5.0
• Instale o SDK do .NET Core 3.1:dotnet-sdk-3.1

Pacote faltando

Se a combinação da versão do pacote não funcionar, ela não está disponível. Por exemplo, não há um ASP.NET Core SDK, os componentes do SDK estão incluídos no .NET SDK. O valor queaspnetcore-sdk-7.0está incorreto e deve serdotnet-sdk-7.0. Para obter uma lista de distribuições do Linux suportadas pelo .NET, consulteDependências e requisitos do .NET.

Use o APT para atualizar o .NET

Quando uma nova versão de patch estiver disponível para .NET, você pode simplesmente atualizá-la por meio do APT com os seguintes comandos:

sudo apt-get updatesudo apt-get upgrade

Se você atualizou sua distribuição Linux desde a instalação do .NET, pode ser necessário reconfigurar o repositório de pacotes da Microsoft. Execute as instruções de instalação para sua versão de distribuição atual para atualizar para o repositório de pacotes apropriado para atualizações .NET.

Solução de problemas

Esta seção fornece informações sobre erros comuns que você pode obter ao usar o APT para instalar o .NET.

Não foi possível encontrar o pacote

Para obter mais informações sobre a instalação do .NETsem um gerenciador de pacotes, consulte um dos seguintes artigos:

• Como alternativa, instale o .NET com o script install-dotnet.
• Instalar manualmente o .NET

Não foi possível localizar \ Alguns pacotes não puderam ser instalados

Se você receber uma mensagem de erro semelhante aNão foi possível localizar o pacote {dotnet-package}ouAlguns pacotes não puderam ser instalados, execute os seguintes comandos.

Existem dois espaços reservados no seguinte conjunto de comandos.

• {dotnet-package}
  Isso representa o pacote .NET que você está instalando, comoaspnetcore-runtime-7.0. Isso é usado no seguintesudo apt-get installcomando.

• {os-version}
  Isso representa a versão de distribuição em que você está. Isso é usado nowgetcomando abaixo. A versão de distribuição é o valor numérico, como20.04no Ubuntu ou10no Debian.

Primeiro, tente limpar a lista de pacotes:

sudo dpkg --purge packages-microsoft-prod && sudo dpkg -i packages-microsoft-prod.debsudo apt-get update

Em seguida, tente instalar o .NET novamente. Se isso não funcionar, você pode executar uma instalação manual com os seguintes comandos:

sudo apt-get install -y gpgwget -O - https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor -o microsoft.asc.gpgsudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/wget https://packages.microsoft.com/config/debian/{os-version}/prod .listsudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.listsudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpgsudo chown root:root /etc/apt /sources.list.d/microsoft-prod.listsudo apt-get update && \ sudo apt-get install -y {dotnet-package}

Falha ao buscar

Ao instalar o pacote .NET, você pode ver um erro semelhante aFalha ao buscar... O arquivo tem tamanho inesperado... Sincronização espelhada em andamento?. Esse erro pode significar que o feed de pacote para .NET está sendo atualizado com versões de pacote mais recentes e que você deve tentar novamente mais tarde. Durante uma atualização, o feed do pacote não deve ficar indisponível por mais de 30 minutos. Se você receber esse erro continuamente por mais de 30 minutos, registre um problema emhttps://github.com/dotnet/core/issues.

Dependências

Quando você instala com um gerenciador de pacotes, essas bibliotecas são instaladas para você. Mas, se você instalar manualmente o .NET ou publicar um aplicativo independente, precisará certificar-se de que essas bibliotecas estejam instaladas:

• libc6
• libgcc-s1
• libgssapi-krb5-2
• libicu63 (para 10.x)
• libicu67 (para 11.x)
• libssl1.1
• libstdc++6
• zlib1g

Se o aplicativo .NET usar oSistema.Desenho.Comumassembly, o libgdiplus também precisará ser instalado. PorqueSystem.Drawing.Common não é mais suportado no Linux, isso só funciona no .NET 6 e requer a configuração doSystem.Drawing.EnableUnixSupportchave de configuração de tempo de execução.

Você pode instalar uma versão recente dolibgdiplusporadicionando o repositório Mono ao seu sistema.

Próximos passos

• Como habilitar o preenchimento TAB para o .NET CLI
• Tutorial: Criar um aplicativo de console com o .NET SDK usando o Visual Studio Code