> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Notas de suporte do GDK para o Visual Studio 2019 > Notas de suporte do Microsoft Game Development Kit (GDK) para o Visual Studio 2019 Este artigo descreve o suporte do Microsoft Game Development Kit (GDK) ao Visual Studio 2019. O Visual Studio 2019 [versão 16.11](https://learn.microsoft.com/visualstudio/releases/2019/servicing-vs2019) dá suporte ao desenvolvimento com o GDK. As versões 16.0 a 16.10 do Visual Studio 2019 estão fora do suporte desde outubro de 2022. A versão 16.11 também está fora do suporte principal. ## Instalar o Visual Studio 2019 O GDK dá suporte ao desenvolvimento com a edição **Professional** ou com a edição **Enterprise** do Visual Studio 2019. A edição Community não tem suporte. Ao instalar o Visual Studio 2019, selecione a carga de trabalho **Game development with C++** durante a instalação, conforme mostrado na captura de tela a seguir. Captura de tela da caixa de diálogo da carga de trabalho Game Development with C++ Além das ferramentas principais de C++ necessárias para o desenvolvimento de jogos, verifique se o componente **Windows 10 SDK (22000)** está instalado para fornecer o Windows SDK necessário para compilar jogos com o GDK. O *Windows SDK for Windows 11, Version 22H2* (10.0.22621) ou o *Windows SDK for Windows 11, Version 24H2* (10.0.26100) também podem ser usados, mas não são obrigatórios. Embora não seja obrigatório, instalar a carga de trabalho **Desktop development with C++** fornece mais ferramentas e exemplos que podem ser úteis. A versão **v142** das ferramentas de build do MSVC é instalada com a carga de trabalho Game development with C++. > O conjunto de ferramentas `v141` do Visual Studio 2017 não tem mais suporte a partir da versão de outubro de 2024. ### Suporte a projetos clang/LLVM para Windows (ClangCl) O Visual Studio 2019 também dá suporte ao desenvolvimento com o clang/LLVM para Windows. Esse suporte requer a instalação de **C++ Clang-cl for Windows** e de **C++ Clang-cl for v142 build tools (x64/x86)**, que são componentes individuais. Para obter mais informações, veja o artigo sobre o Clang do [Microsoft Game Development Kit (GDK)](/pt-BR/tools/tools-console/visualstudio/vs-clang) e o [Microsoft Docs](https://learn.microsoft.com/cpp/build/clang-support-msbuild). ### Edição Build Tools Use o **Build Tools for Visual Studio 2019** para compilar com os cabeçalhos, as bibliotecas e as ferramentas do Microsoft GDK seguindo as [instruções de Build With/Out Install](/pt-BR/build/console-features/build-without-install/withoutinstall-overview). * Use a carga de trabalho *Desktop Development with C++*, que instala o compilador Visual C++ para o PlatformToolset `v142`. Você também pode selecionar componentes para o suporte a `ClangCl` de acordo com as instruções apresentadas anteriormente neste artigo. * Instale o Windows SDK ou use-o como um pacote [NuGet](https://www.nuget.org/packages/Microsoft.Windows.SDK.CPP.x64/). > A edição Build Tools não dá suporte a extensões, portanto você não pode instalar os pacotes VSIX do Microsoft GDK na edição Build. Essa limitação significa que ela não dá suporte à implantação nem à depuração, embora você possa usar as ferramentas de linha de comando. ## Migrar projetos existentes do Visual Studio 2017 para o Visual Studio 2019 Na maioria dos casos, o assistente de atualização fornecido com o Visual Studio pode migrar seu projeto para o Visual Studio 2019 sem nenhuma outra alteração. Quando você abre um projeto do Visual Studio 2017 no Visual Studio 2019, é exibida a caixa de diálogo **Review Solution Actions** a seguir, que solicita a atualização. Para atualizar o projeto, selecione **OK**. Captura de tela da caixa de diálogo Review Solution Actions do assistente de atualização no Visual Studio 2019, mostrando as opções de redirecionamento para um projeto do Visual Studio 2017 Você também pode optar por usar o IDE do Visual Studio 2019 sem atualizar suas ferramentas de build. Para isso, selecione **Cancel** na caixa de diálogo **Review Solution Actions**. ### Atualizar projetos manualmente para o Visual Studio 2019 Se quiser atualizar seu projeto editando diretamente os arquivos de projeto (.vcxproj), faça as alterações a seguir. 1. Altere todas as instâncias de `PlatformToolset` de `v141` para `v142`. O exemplo a seguir mostra como fazer essa alteração. ```xml theme={null} v141 ... v142 ``` 1. Recompile o projeto. ## Usar versões específicas Por padrão, o Visual Studio Installer sempre baixa a versão mais recente. Em um ambiente Enterprise, você pode controlar a versão específica usando um layout offline. Para obter mais informações, veja [Controlling updates to Visual Studio deployments](https://learn.microsoft.com/visualstudio/install/controlling-updates-to-visual-studio-deployments). Esse artigo também fornece informações sobre como remover o ícone de **notificação do VS**. Baixe versões específicas do Visual Studio 2019 em [Visual Studio 2019 Releases](https://learn.microsoft.com/visualstudio/releases/2019/history). ## Problemas conhecidos * As funções `*IsNan` do DirectXMath podem falhar com o Visual Studio 2019 quando compiladas com `/fp:fast`. A correção é usar o Visual Studio 2019 (16.3 ou posterior). Caso contrário, você pode contornar o problema colocando instruções `#pragma float_control` em torno do uso dessas funções. * Somente o conjunto de ferramentas de compilador nativo de 64 bits tem suporte para o desenvolvimento com o GDK. Em um `vcxproj` do Visual C++, defina esse conjunto de ferramentas nas propriedades globais: ```xml theme={null} x64 ``` * Os cabeçalhos pré-compilados têm problemas conhecidos nas versões do clang/LLVM para Windows anteriores à v11. Dependendo do seu PCH e do uso de modelos C++, talvez seja necessário adicionar `-fno-pch-instantiate-templates` para compilar com êxito. * As [atualizações do .NET Core 2.1 fornecidas pelo Microsoft Update](https://devblogs.microsoft.com/dotnet/net-core-updates-coming-to-microsoft-update/) podem bloquear a instalação do GDK. Para obter mais informações sobre esse problema, veja a [notificação de fim do suporte do .NET Core 2.1](https://devblogs.microsoft.com/dotnet/net-core-2-1-will-reach-end-of-support-on-august-21-2021/). Para resolver esse problema: * Execute o Visual Studio Installer * Selecione o botão **Modify** do Visual Studio 2019 * Selecione a guia **Individual** components e remova o [componente .NET Core 2.1 Runtime (LTS)](https://learn.microsoft.com/visualstudio/install/workload-component-id-vs-enterprise) * Tente desinstalar e reinstalar o GDK novamente ## Relatar bugs Relate bugs do **compilador Visual C++** (se possível) por meio de *Report a Problem...* do Visual Studio. Veja o [Microsoft Docs](https://learn.microsoft.com/visualstudio/ide/how-to-report-a-problem-with-visual-studio) e o site da [Developer Community](https://aka.ms/feedback/report?space=62). Para obter detalhes sobre como criar um bom relatório de bug para o compilador, veja [esta página](https://aka.ms/compilerbug). Você pode adicionar um comentário marcado como "Microsoft only" a um relatório público de problema se forem necessárias outras informações sob NDA para reproduzir o problema. Para relatar bugs do **compilador clang/LLVM para Windows**, use [https://bugs.llvm.org/](https://bugs.llvm.org/) Para relatar bugs da **Microsoft Standard C++ Library** (também conhecida como STL), use [https://github.com/microsoft/STL/issues](https://github.com/microsoft/STL/issues) Como sempre, fique à vontade para entrar em contato com seu *representante da Microsoft* sobre problemas críticos que precisem ser escalonados. ## Veja também [Visual Studio](/pt-BR/tools/tools-console/visualstudio/visualstudio) [Visual Studio Product Lifecycle and Servicing](https://learn.microsoft.com/visualstudio/releases/2019/servicing-vs2019) ## Related topics - [Notas de suporte do Visual Studio 2019](/pt-BR/tools/tools-pc/visualstudio/gr-vs-2019-support-notes.md) - [Notas de suporte do GDK para o Visual Studio 2026](/pt-BR/tools/tools-console/visualstudio/vs-2026-support-notes.md) - [Notas de suporte do GDK para o Visual Studio 2022](/pt-BR/tools/tools-console/visualstudio/vs-2022-support-notes.md) - [Notas de suporte do Visual Studio 2022](/pt-BR/tools/tools-pc/visualstudio/gr-vs-2022-support-notes.md) - [Visual Studio](/pt-BR/tools/tools-pc/visualstudio/index.md)