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 é 7.
Há dois tipos de versões com suporte, versões LTS (Suporte de Longo Prazo) ou STS (Suporte a Prazo Padrão). A qualidade de todas as versões é a mesma. A única diferença é o comprimento do suporte. As versões lts recebem suporte e patches gratuitos por 3 anos. As versões do STS recebem suporte e patches gratuitos por 18 meses. Para obter mais informações, consulte Política de suporte do .NET.
A tabela a seguir lista o status de suporte de cada versão do .NET (e do .NET Core):
| ✔️ Com suporte | ❌ Sem suporte |
|---|---|
| 7 (STS) | 5 |
| 6 (LTS) | 3,0 |
| 3.1 (LTS) | 2,2 |
| 2.1 | |
| 2,0 | |
| 1,1 | |
| 1.0 |
Instalar com Gerenciador de Pacotes do Windows (winget)
Você pode instalar e gerenciar o .NET por meio do serviço Gerenciador de Pacotes do Windows, usando a ferramenta winget. Para obter mais informações sobre como instalar e usar o winget, consulte Usar a ferramenta winget.
Se você estiver instalando o .NET em todo o sistema, instale com privilégios administrativos.
Instalar o SDK
O SDK do .NET permite que você desenvolva aplicativos com o .NET. Se você instalar o SDK do .NET, não precisará instalar os runtimes correspondentes. Para instalar o SDK do .NET, execute o seguinte comando:
winget install Microsoft.DotNet.SDK.7
Instalar o runtime
Para o Windows, há três runtimes do .NET que você pode instalar. Você deve instalar o Runtime da Área de Trabalho do .NET e o runtime do ASP.NET Core para garantir que você seja compatível com todos os tipos de aplicativos .NET.
Runtime do .NET Desktop
Esse runtime inclui o runtime base do .NET e dá suporte a aplicativos de Windows Presentation Foundation (WPF) e Windows Forms criados com o .NET. Isso não é o mesmo que .NET Framework, que vem com o Windows.
winget install Microsoft.DotNet.DesktopRuntime.7Runtime do ASP.NET Core
Esse runtime inclui o runtime base do .NET e executa aplicativos de servidor Web. O Runtime do ASP.NET Core permite executar aplicativos feitos com o .NET que não forneceram o runtime. O comando a seguir instala o runtime do ASP.NET Core, que é o runtime mais compatível com o .NET. Em seu terminal, execute os seguintes comandos:
winget install Microsoft.DotNet.AspNetCore.7Execução do .NET
Esse é o runtime base e contém apenas os componentes necessários para executar um aplicativo de console. Normalmente, você instalaria os outros runtimes.
winget install Microsoft.DotNet.Runtime.7
Você pode instalar versões prévias dos runtimes substituindo o número de versão, como 6, pela palavra Preview. O exemplo a seguir instala a versão prévia do Runtime da Área de Trabalho do .NET:
winget install Microsoft.DotNet.DesktopRuntime.Preview
Instalar junto com o Visual Studio Code
Visual Studio Code é um editor de código-fonte leve e avançado 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 o Visual Studio, adicionar suporte ao .NET Core é simples.
- Baixar e instalar o Visual Studio Code.
- Baixar e instalar o .NET SDK.
- Instalar a extensão C# do Visual Studio Code Marketplace.
Instalar com o Windows Installer
A página de download do .NET fornece executáveis do Windows Installer.
Ao usar os instaladores do Windows para instalar o .NET, você pode personalizar o caminho de instalação definindo os parâmetros DOTNETHOME_X64 e DOTNETHOME_X86:
dotnet-sdk-7.0.100-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 exibidas./norestart
Suprime todas as tentativas de reinicialização.
dotnet-sdk-7.0.100-win-x64.exe /install /quiet /norestart
Para obter mais informações, consulte Opções de linha de comando 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.
Instalar com a automação do PowerShell
Os scripts dotnet-install são usados para instalações de automação e não administrativas do SDK e 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 definindo a opção Channel . Inclua a opção Runtime para instalar um runtime. Caso contrário, o script instala o SDK.
O comando a seguir instala o runtime do ASP.NET Core para compatibilidade máxima. O runtime ASP.NET Core também inclui o runtime padrão do .NET.
dotnet-install.ps1 -Channel 7.0 -Runtime aspnetcore
Instale o SDK omitindo a opção -Runtime. A -Channel opção é definida neste exemplo como STS, que instala a versão mais recente do Suporte a Termos Padrão (.NET 7).
dotnet-install.ps1 -Channel STS
Instalar com o Visual Studio
Se você estiver usando o Visual Studio para desenvolver aplicativos .NET, a tabela a seguir descreverá 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 |
|---|---|
| 7 | Visual Studio 2022 versão 17.4 ou superior. |
| 6 | Visual Studio 2022 versão 17.0 ou superior. |
| 5 | Visual Studio 2019 versão 16.8 ou superior. |
| 3.1 | Visual Studio 2019 versão 16.4 ou superior. |
| 3,0 | Visual Studio 2019 versão 16.3 ou superior. |
| 2,2 | Visual Studio 2017 versão 15.9 ou superior. |
| 2.1 | Visual Studio 2017 versão 15.7 ou superior. |
Se você já tiver o Visual Studio instalado, poderá verificar sua versão com as etapas a seguir.
- Abra o Visual Studio.
- Selecione Ajuda>sobre o Microsoft Visual Studio.
- Leia o número da versão da caixa de diálogo Sobre .
O Visual Studio pode instalar o SDK e o runtime mais recentes do .NET.
Selecionar uma carga de trabalho
Ao instalar ou modificar o 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 trabalhoASP.NET e desenvolvimento web na seção Web & Nuvem.
- A carga de trabalho de desenvolvimento do Azure na seção Web & Nuvem
- A carga de trabalho de desenvolvimento da área de trabalho do .NET na seção Desktop & Mobile.
Versões com suporte
A tabela a seguir é uma lista de versões .NET atualmente com suporte e as versões do Windows nas quais elas têm suporte. Essas versões permanecerão 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 do Windows para obter detalhes específicos.
Dica
Um símbolo + representa a versão mínima.
| Sistema operacional | .NET 7 | .NET 6 | .NET Core 3.1 |
|---|---|---|---|
| Windows 11 | ✔️ | ✔️ | ✔️ |
| Windows Server 2022 | ✔️ | ✔️ | ✔️ |
| Windows Server, versão 1903 ou posterior | ✔️ | ✔️ | ✔️ |
| Windows 10, versão 1607 ou posterior | ✔️ | ✔️ | ✔️ |
| Windows 8.1 | ❌ | ✔️ | ✔️ |
| Windows 7 SP1 ESU | ❌ | ✔️ | ✔️ |
| 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, distribuições e política de ciclo de vida com suporte do .NET 7, consulte Versões do sistema operacional com suporte do .NET 7.
Versões sem suporte
Não ❌ há mais suporte para as seguintes versões do .NET:
- .NET 5
- .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:
Runtime do ASP.NET Core
Executa aplicativos ASP.NET Core. Inclui o runtime do .NET.Runtime do desktop
Executa os aplicativos da área de trabalho .NET WPF e Windows Forms 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 ASP.NET Core runtime e o runtime da Área de Trabalho para obter a melhor compatibilidade com aplicativos .NET.
Informações do SDK
O SDK é usado para compilar e publicar aplicativos e bibliotecas .NET. A instalação do SDK inclui os três runtimes: ASP.NET Core, Desktop e .NET.
Computadores Windows baseados em Arm
As seções a seguir descrevem as coisas que você deve considerar ao instalar o .NET em um computador 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 caminhos |
|---|---|---|---|---|
| 7 | Arm64 | Sim | Sim | Não |
| 7 | x64 | Sim | Sim | Não |
| 6 | Arm64 | Sim | Sim | Não |
| 6 | x64 | Sim | Sim | Não |
| 5 | Arm64 | Sim | Sim | Sim |
| 5 | x64 | Não | Sim | Sim |
| 3.1 | Arm64 | Não | Não | N/D |
| 3.1 | x64 | Não | Sim | Sim |
A partir do .NET 6, as versões x64 e Arm64 do SDK do .NET existem independentemente umas das outras. Se uma nova versão for lançada, cada instalação de arquitetura precisará ser atualizada.
Diferenças de caminho
Em um computador 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 ou do SDK do .NET 7, ela é instalada na pasta C:\Arquivos de Programas\dotnet\x64\ .
Conflitos de caminho
A partir do .NET 6, o SDK do .NET 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 existam no mesmo computador. No entanto, nenhum SDK x64 anterior ao 6 não tem suporte e é instalado no mesmo local que a versão do Arm64, a pasta C:\Program Files\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, podem precisar ser alteradas se você tiver as versões x64 e Arm64 do SDK do .NET 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.
Dependências
As seguintes versões do Windows têm suporte no .NET 7:
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, distribuições e política de ciclo de vida compatíveis com o .NET 7, consulte Versões do sistema operacional com suporte do .NET 7.
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 do Windows:
| Sistema operacional | Pré-requisitos |
|---|---|
| Windows 7 SP1 ESU | - Microsoft Visual C++ 2015-2019 redistribuível 64-bit / 32-bit - KB3063858 64-bit / 32-bit - Autoridade de certificado raiz da Microsoft 2011 (.NET Core 2.1 offline installer only) |
| Windows Vista SP2 | Microsoft Visual C++ 2015-2019 redistribuível 64-bit / 32-bit |
| Windows 8.1 | Microsoft Visual C++ 2015-2019 redistribuível 64-bit / 32-bit |
| Windows Server 2008 R2 | Microsoft Visual C++ 2015-2019 redistribuível 64-bit / 32-bit |
| Windows Server 2012 | Microsoft Visual C++ 2015-2019 redistribuível 64-bit / 32-bit |
| Windows Server 2012 R2 | Microsoft Visual C++ 2015-2019 redistribuível 64-bit / 32-bit |
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
Docker
Os contêineres fornecem uma maneira leve de isolar seu 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 Docker do .NET Core são publicadas no MCR (Registro de Contêiner da Microsoft) e podem ser encontradas no repositório do Docker Hub do .NET Core da Microsoft. 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 comando dotnet, ele está resolvendo para a versão x86 quando ele deve ser resolvido para a versão x64. Isso geralmente é corrigido ajustando a variável %PATH% para resolver a versão x64 primeiro.
Verifique se você tem as duas versões instaladas executando o comando
where.exe dotnet. Se tiver, você deverá ver uma entrada para as pastas Arquivos de Programas e Arquivos 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.exeSe 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
Pressione o botão do Windows e digite "Editar as variáveis de ambiente do sistema" na pesquisa. Selecione Editar as variáveis de ambiente do sistema.
A janela Propriedades do Sistema é aberta para a guia Avançado. Selecione Variáveis de Ambiente.
Na janela Variáveis de Ambiente, no grupo variáveis do sistema , selecione a linha Caminho* e, em seguida, o botão Editar .
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\.
