Instalar o .NET no Windows

Neste artigo, você aprenderá a instalar o .NET no Windows. O .NET é composto pelo runtime e pelo SDK. O runtime é usado para executar um aplicativo .NET e pode ou não ser incluído com o aplicativo. O SDK é usado para criar bibliotecas e aplicativos .NET. O runtime do .NET é sempre instalado com o SDK.

A versão mais recente do .NET é 6.

Versões com suporte

A tabela a seguir é uma lista de versões do .NET com suporte no momento e as versões do Windows em que eles têm suporte. Essas versões permanecem com suporte até que a versão do .NET atinja o fim do suporte ou a versão do Windows atinja o fim da vida útil.

Windows 10 datas de fim de serviço de versões são segmentadas por edição. Somente as edições Home, Pro, Pro Education e Pro for Workstations são consideradas na tabela a seguir. Verifique a folha de fatos do ciclo de vida Windows para obter detalhes específicos.

Dica

Um + símbolo representa a versão mínima.

Sistema operacional .NET Core 3.1 .NET 5 .NET 6
Windows 11 ✔️ ✔️
Windows Server 2022 ✔️ ✔️
Windows 10 versão 21H1 ✔️ ✔️
Windows 10/Windows Server, versão 20H2 ✔️ ✔️
Windows 10/Windows Server, versão 2004 ✔️ ✔️
Windows 10/Windows Server, versão 1909 ✔️ ✔️
Windows 10/Windows Server, versão 1903 ✔️ ✔️
Windows 10, versão 1809 ✔️ ✔️
Windows 10, versão 1803 ✔️ ✔️
Windows 10, versão 1709 ✔️ ✔️
Windows 10, versão 1607 ✔️ ✔️
Windows 8.1 ✔️ ✔️
Windows ESU 7 SP1 ✔️ ✔️
Windows Server 2019
Windows Server 2016
Windows Server 2012 R2
Windows Server 2012
✔️ ✔️ ✔️
Windows Server Core 2012 R2 ✔️ ✔️
Windows Server Core 2012 ✔️ ✔️
Nano Server, versão 1809+ ✔️ ✔️
Nano Server, versão 1803 ✔️

Para obter mais informações sobre sistemas operacionais compatíveis com .NET 6, distribuições e política de ciclo de vida, consulte versões do sistema operacional com suporte do .NET 6.

Versões sem suporte

Não há ❌ mais suporte para as versões a seguir do .NET. Os downloads para estes ainda permanecem publicados:

  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET Core 2.0

Informações de runtime

O runtime é usado para executar aplicativos criados com .NET. Quando um autor de aplicativo publica um aplicativo, ele pode incluir o runtime com seu aplicativo. Se eles não incluirem o runtime, cabe ao usuário instalar o runtime.

Há três runtimes diferentes que você pode instalar no Windows:

  • ASP.NET Core runtime
    Executa ASP.NET Core aplicativos. Inclui o runtime do .NET.

  • Runtime da área de trabalho
    Executa aplicativos .NET WPF e Windows Forms desktop para Windows. Inclui o runtime do .NET.

  • Runtime do .NET
    Esse runtime é o runtime mais simples e não inclui nenhum outro runtime. É altamente recomendável que você instale o runtime ASP.NET Core e o runtime da área de trabalho para obter a melhor compatibilidade com aplicativos .NET.

Informações do SDK

O SDK é usado para criar e publicar bibliotecas e aplicativos .NET. A instalação do SDK inclui todos os três runtimes: ASP.NET Core, Desktop e .NET.

PCs de Windows baseados em braço

As seções a seguir descrevem as coisas que você deve considerar ao instalar o .NET em um computador de Windows baseado em Arm.

O que tem suporte

A tabela a seguir descreve quais versões do .NET têm suporte em um computador Windows baseado em Arm:

Versão .NET Arquitetura . Runtime Conflito de caminho
6,0 Arm64 Sim Sim Não
6,0 x64 Sim Sim Não
5,0 Arm64 Sim Sim Sim
5,0 x64 Não Sim Sim
3.1 Arm64 Não Não N/D
3.1 x64 Não Sim Sim

As versões x64 e Arm64 do SDK do .NET 6 existem independentemente umas das outras. Se uma nova versão for lançada, cada instalação precisará ser atualizada.

Diferenças de caminho

Em um computador de Windows baseado em Arm, todas as versões do Arm64 do .NET são instaladas na pasta C:\Program Files\dotnet\ normal. No entanto, quando você instala a versão x64 do SDK do .NET 6, ela é instalada na pasta C:\Program Files\dotnet\x64\ .

Conflitos de caminho

O SDK do .NET 6 x64 é instalado em seu próprio diretório, conforme descrito na seção anterior. Isso permite que as versões arm64 e x64 do SDK do .NET 6 existam no mesmo computador. No entanto, não há suporte para qualquer SDK x64 antes do 6.0 e é instalado no mesmo local que a versão do Arm64, a pasta C:\Arquivos de Programas\dotnet\ . Se você quiser instalar um SDK x64 sem suporte, precisará primeiro desinstalar a versão do Arm64. O oposto também é verdadeiro, você precisará desinstalar o SDK x64 sem suporte para instalar a versão do Arm64.

Variáveis de caminho

As variáveis de ambiente que adicionam o .NET ao caminho do sistema, como a PATH variável, talvez precisem ser alteradas se você tiver as versões x64 e Arm64 do SDK do .NET 6 instaladas. Além disso, algumas ferramentas dependem da DOTNET_ROOT variável de ambiente, que também precisaria ser atualizada para apontar para a pasta de instalação apropriada do SDK do .NET 6.

Dependências

As seguintes versões de Windows têm suporte com o .NET 6:

Observação

Um + símbolo representa a versão mínima.

Sistema operacional Versão Arquiteturas
Windows 11 21H2 x64, Arm64
Cliente do Windows 10 1607+ x64, x86, Arm64
Windows Client 7 SP1+, 8.1 x64, x86
Windows Server 2012+ x64, x86
Núcleo do Windows Server 2012+ x64, x86
Nano Server 1809+ x64

Para obter mais informações sobre sistemas operacionais compatíveis com .NET 6, distribuições e política de ciclo de vida, consulte versões do sistema operacional com suporte do .NET 6.

Windows 7 / Vista / 8.1 / Server 2008 R2 / Server 2012 R2

Mais dependências serão necessárias se você estiver instalando o SDK do .NET ou o runtime nas seguintes versões Windows:

Sistema operacional Pré-requisitos
Windows ESU 7 SP1 - Microsoft Visual C++ 2015-2019 Redistribuível de 64bits32 / bits
- KB3063858 de 64 bits32 / bits
- Microsoft Root Certificate Authority 2011 (somente instalador offline do .NET Core 2.1)
Windows Vista SP 2 Microsoft Visual C++ 2015-2019 Redistribuível de 64bits32 / bits
Windows 8.1 Microsoft Visual C++ 2015-2019 Redistribuível de 64bits32 / bits
Windows Server 2008 R2 Microsoft Visual C++ 2015-2019 Redistribuível de 64bits32 / bits
Windows Server 2012 Microsoft Visual C++ 2015-2019 Redistribuível de 64bits32 / bits
Windows Server 2012 R2 Microsoft Visual C++ 2015-2019 Redistribuível de 64bits32 / bits

Os requisitos anteriores também serão necessários se você receber um erro relacionado a qualquer uma das seguintes dlls:

  • api-ms-win-crt-runtime-l1-1-0.dll
  • api-ms-win-cor-timezone-l1-1-0.dll
  • hostfxr.dll

Instalar com a automação do PowerShell

Os scripts de instalação de dotnet são usados para instalações de automação de CI e não administrador do runtime. Você pode baixar o script na página de referência de script dotnet-install.

O script usa como padrão a instalação da versão lts (suporte de longo prazo) mais recente, que é o .NET 6. Você pode escolher uma versão específica especificando a opção Channel . Inclua a opção Runtime para instalar um runtime. Caso contrário, o script instala o SDK.

dotnet-install.ps1 -Channel 6.0 -Runtime aspnetcore

Instale o SDK omitindo a opção -Runtime . A -Channel opção é definida neste exemplo como Current, que instala a versão mais recente com suporte.

dotnet-install.ps1 -Channel Current

Instalar com Visual Studio

Se você estiver usando Visual Studio para desenvolver aplicativos .NET, a tabela a seguir descreve a versão mínima necessária do Visual Studio com base na versão de destino do SDK do .NET.

Versão do SDK do .NET Versão do Visual Studio
6,0 Visual Studio versão 17.0 ou superior de 2022.
5,0 Visual Studio versão 16.8 ou superior de 2019.
3.1 Visual Studio versão 16.4 ou superior de 2019.
3.0 Visual Studio versão 16.3 ou superior de 2019.
2.2 Visual Studio versão 15.9 ou superior de 2017.
2.1 Visual Studio versão 15.7 ou superior de 2017.

Se você já tiver Visual Studio instalado, poderá verificar sua versão com as etapas a seguir.

  1. Abra o Visual Studio.
  2. Selecione HelpAbout>Microsoft Visual Studio.
  3. Leia o número da versão da caixa de diálogo Sobre .

Visual Studio pode instalar o SDK e o runtime mais recentes do .NET.

Selecionar uma carga de trabalho

Ao instalar ou modificar Visual Studio, selecione uma ou mais das seguintes cargas de trabalho, dependendo do tipo de aplicativo que você está criando:

  • A carga de trabalho de desenvolvimento multiplataforma do .NET Core na seção Outros Conjuntos de Ferramentas .
  • A carga de trabalho de ASP.NET e desenvolvimento web na seção nuvem da Web&.
  • A carga de trabalho de desenvolvimento do Azure na seção Nuvem da Web&.
  • A carga de trabalho de desenvolvimento da área de trabalho do .NET na seção Desktop & Mobile .

Windows Visual Studio 2019 with .NET Core workload

Instalar junto com Visual Studio Code

Visual Studio Code é um editor de código-fonte avançado e leve que é executado em sua área de trabalho. Visual Studio Code está disponível para Windows, macOS e Linux.

Embora Visual Studio Code não venha com um instalador automatizado do .NET Core como Visual Studio, adicionar suporte ao .NET Core é simples.

  1. Baixe e instale Visual Studio Code.
  2. Baixe e instale o SDK do .NET.
  3. Instale a extensão C# do marketplace Visual Studio Code.

Windows Installer

A página de download do .NET fornece Windows executáveis do Instalador.

Ao usar os instaladores Windows para instalar o .NET, você pode personalizar o caminho de instalação definindo os parâmetros e DOTNETHOME_X86 os DOTNETHOME_X64 parâmetros:

dotnet-sdk-3.1.301-win-x64.exe DOTNETHOME_X64="F:\dotnet\x64" DOTNETHOME_X86="F:\dotnet\x86"

Se você quiser instalar o .NET silenciosamente, como em um ambiente de produção ou para dar suporte à integração contínua, use as seguintes opções:

  • /install
    Instala o .NET.

  • /quiet
    Impede que qualquer interface do usuário e prompts sejam exibidos.

  • /norestart
    Suprime todas as tentativas de reinicialização.

dotnet-sdk-3.1.301-win-x64.exe /install /quiet /norestart

Para obter mais informações, consulte Opções de Command-Line do Instalador Padrão.

Dica

O instalador retorna um código de saída 0 para êxito e um código de saída de 3010 para indicar que uma reinicialização é necessária. Qualquer outro valor geralmente é um código de erro.

Baixar e instalar manualmente

Como alternativa aos instaladores Windows para .NET, você pode baixar e instalar manualmente o SDK ou o runtime. A instalação manual geralmente é feita como parte do teste de integração contínua. Para um desenvolvedor ou usuário, geralmente é melhor usar um instalador.

O SDK do .NET e o .NET Runtime podem ser instalados manualmente depois de baixados. Se você instalar o SDK do .NET, não precisará instalar o runtime correspondente. Primeiro, baixe uma versão binária para o SDK ou o runtime de um dos seguintes sites:

Crie um diretório para extrair o .NET para, por exemplo %USERPROFILE%\dotnet. Em seguida, extraia o arquivo zip baixado nesse diretório.

Por padrão, os comandos e aplicativos da CLI do .NET não usarão o .NET instalado dessa forma e você deve optar explicitamente por usá-lo. Para fazer isso, altere as variáveis de ambiente com as quais um aplicativo é iniciado:

set DOTNET_ROOT=%USERPROFILE%\dotnet
set PATH=%USERPROFILE%\dotnet;%PATH%
set DOTNET_MULTILEVEL_LOOKUP=0

Essa abordagem permite que você instale várias versões em locais separados e escolha explicitamente qual local de instalação um aplicativo deve usar executando o aplicativo com variáveis de ambiente apontando para esse local.

Quando DOTNET_MULTILEVEL_LOOKUP definido como 0, o .NET ignora qualquer versão do .NET instalada globalmente. Remova essa configuração de ambiente para permitir que o .NET considere o local de instalação global padrão ao selecionar a melhor estrutura para executar o aplicativo. Normalmente, o padrão é C:\Program Files\dotnet, que é onde os instaladores instalam o .NET.

Docker

Os contêineres fornecem uma maneira leve de isolar o aplicativo do restante do sistema host. Os contêineres no mesmo computador compartilham apenas o kernel e usam recursos fornecidos ao seu aplicativo.

O .NET pode ser executado em um contêiner do Docker. As imagens oficiais do .NET Docker são publicadas no Microsoft Container Registry (MCR) e podem ser descobertas no repositório microsoft .NET Docker Hub. Cada repositório contém imagens para diferentes combinações do .NET (SDK ou Runtime) e do sistema operacional que você pode usar.

A Microsoft fornece imagens personalizadas para cenários específicos. Por exemplo, o repositório do ASP.NET Core fornece imagens que são criadas para a execução de aplicativos ASP.NET Core na produção.

Para obter mais informações sobre como usar o .NET em um contêiner do Docker, consulte Introdução ao .NET e docker e exemplos.

Solução de problemas

Depois de instalar o SDK do .NET, você pode ter problemas ao tentar executar comandos da CLI do .NET. Esta seção coleta esses problemas comuns e fornece soluções.

Não foi possível localizar nenhum SDK do .NET Core instalado

Provavelmente você instalou as versões x86 (32 bits) e x64 (64 bits) do SDK do .NET. Isso está causando um conflito porque quando você executa o dotnet comando ele está resolvendo para a versão x86 quando ele deve ser resolvido para a versão x64. Isso geralmente é corrigido ajustando a %PATH% variável para resolver a versão x64 primeiro.

  1. Verifique se você tem as duas versões instaladas executando o where.exe dotnet comando. Se o fizer, você deverá ver uma entrada para as pastas Arquivos de Programas eArquivos de Programas (x86)\ . Se a pasta Arquivos de Programas (x86)\ for a primeira conforme indicado pelo exemplo a seguir, ela estará incorreta e você deverá continuar para a próxima etapa.

    > where.exe dotnet
    C:\Program Files (x86)\dotnet\dotnet.exe  
    C:\Program Files\dotnet\dotnet.exe
    

    Se estiver correto e os Arquivos de Programas\ estiverem em primeiro lugar, você não terá o problema que esta seção está discutindo e você deve criar um problema de solicitação de ajuda do .NET no GitHub

  2. Pressione o botão Windows e digite "Editar as variáveis de ambiente do sistema" na pesquisa. Selecione Editar as variáveis de ambiente do sistema.

    Windows start menu with edit environment variable

  3. A janela Propriedades do Sistema é aberta para a Guia Avançada. Selecione Variáveis de Ambiente.

    The Windows system properties panel open.

  4. Na janela Variáveis de Ambiente , no grupo De variáveis do sistema , selecione a linha Caminho* e, em seguida, selecione o botão Editar .

    The environment variables window with user and system variables.

  5. Use os botões Mover para cima e mover para baixo para mover a entrada C:\Arquivos de Programas\dotnet\ acima de C:\Arquivos de Programas (x86)\dotnet\.

    The environment variables list for the system.

Próximas etapas