> ## Documentation Index > Fetch the complete documentation index at: https://docs.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. > [!NOTE] > > 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++](https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_workloads_game_devlopment.png?fit=max\&auto=format\&n=NsRUQ49ZRpXgoZ9R\&q=85\&s=4fb4b71036246e053fa20ee3270bb27b) 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)](https://docs.xbox.com/pt-BR/tools/tools-console/visualstudio/vs-clang.md) 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](https://docs.xbox.com/pt-BR/build/console-features/build-without-install/withoutinstall-overview.md). * 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](https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/vs_convert_2017_to_2019.png?fit=max\&auto=format\&n=6TXzXmujKayly5Sf\&q=85\&s=77e8e2059ed810747afecaea859027a2) 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). > [!NOTE] > > 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](https://docs.xbox.com/pt-BR/tools/tools-console/visualstudio/visualstudio.md) [Visual Studio Product Lifecycle and Servicing](https://learn.microsoft.com/visualstudio/releases/2019/servicing-vs2019) ## Related topics - [Notas de suporte do Visual Studio 2019](https://docs.xbox.com/pt-BR/tools/tools-pc/visualstudio/gr-vs-2019-support-notes.md) - [Notas de suporte do GDK para o Visual Studio 2026](https://docs.xbox.com/pt-BR/tools/tools-console/visualstudio/vs-2026-support-notes.md) - [Notas de suporte do GDK para o Visual Studio 2022](https://docs.xbox.com/pt-BR/tools/tools-console/visualstudio/vs-2022-support-notes.md) - [Notas de suporte do Visual Studio 2022](https://docs.xbox.com/pt-BR/tools/tools-pc/visualstudio/gr-vs-2022-support-notes.md) - [Visual Studio (conteúdo)](https://docs.xbox.com/pt-BR/tools/tools-pc/visualstudio/gr-visualstudio-toc.md)