> ## 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 Visual Studio 2019 > Notas de suporte do Visual Studio 2019 Este tópico descreve o suporte do Microsoft Game Development Kit (GDK) ao Visual Studio 2019. A [versão 16.11](https://learn.microsoft.com/visualstudio/releases/2019/servicing-vs2019) do Visual Studio 2019 é compatível com o desenvolvimento no Microsoft Game Development Kit (GDK). > [!NOTE] > > As versões 16.0 a 16.10 do Visual Studio 2019 estão sem suporte desde outubro de 2022. ## Instalar o Visual Studio 2019 Ao instalar o Visual Studio 2019, você deve selecionar a carga de trabalho **Desenvolvimento de jogos com C++** durante a configuração, conforme mostrado na captura de tela a seguir. ![Captura de tela da caixa de diálogo da carga de trabalho Desenvolvimento de jogos com 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 para PC com Windows, o Desenvolvimento de jogos com C++ também inclui a versão do Windows 10 SDK necessária para compilar jogos para PC com Windows com o Microsoft Game Development Kit (GDK). Embora não seja obrigatório, instalar a carga de trabalho Desenvolvimento para desktop com C++ fornece ferramentas e exemplos adicionais que podem ser úteis. Dependendo das suas necessidades, você pode optar por instalar cargas de trabalho ou componentes opcionais adicionais. * Se você estiver criando um jogo que usa o Unity, instale a carga de trabalho **Desenvolvimento de jogos com Unity**. * A versão **v142** das ferramentas de build do MSVC é instalada com a carga de trabalho Desenvolvimento de jogos com C++. Se necessário, você pode usar o ambiente de desenvolvimento integrado (IDE) do Visual Studio 2019 com as ferramentas do MSVC incluídas no Visual Studio 2017 (**v141**). Usar o IDE mais recente sem atualizar para o novo conjunto de ferramentas permite aproveitar os novos recursos do IDE sem precisar atualizar o código-fonte para funcionar com o novo compilador. > Para usar o conjunto de ferramentas do Visual Studio 2017 com o IDE do Visual Studio 2019, instale o componente **MSVC v141 - VS 2017 C++ x64/x86 build tools (v14.16)** na carga de trabalho **Desenvolvimento para desktop com C++**, conforme mostrado na captura de tela a seguir. O conjunto de ferramentas do Visual Studio 2017 não é mais compatível a partir da versão de outubro de 2024. * Para depurar seu jogo em um PC remoto, veja [Depuração remota de um projeto C++ no Visual Studio](https://learn.microsoft.com/visualstudio/debugger/remote-debugging-cpp) para obter instruções sobre como instalar as Ferramentas Remotas do Visual Studio. ## 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. Ao abrir um projeto do Visual Studio 2017 no Visual Studio 2019, você verá a seguinte caixa de diálogo Revisar Ações da Solução, que solicita a atualização. Para atualizar o projeto, selecione **OK**. ![Captura de tela da caixa de diálogo Revisar Ações da Solução do assistente de atualização no Visual Studio 2019, mostrando 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 as ferramentas de build. Para isso, selecione **Cancelar** na caixa de diálogo **Revisar Ações da Solução**. ### Atualizar projetos manualmente para o Visual Studio 2019 Se quiser atualizar o projeto editando diretamente os arquivos de projeto (.vcxproj), você precisará fazer as alterações a seguir. 1. Adicione `WindowsTargetPlatformVersion` ao grupo de propriedades `Globals`. Defina o valor como 10.0. Veja um exemplo a seguir. ```xml theme={null} 10.0 ... ``` 1. Altere todas as instâncias de `PlatformToolset` de v141 para v142. Veja um exemplo a seguir. ```xml theme={null} v141 ... v142 ``` 1. Recompile o projeto. ### Suporte a projetos clang/LLVM for Windows (ClangCl) O Visual Studio 2019 também oferece suporte ao desenvolvimento com clang/LLVM for Windows. Isso requer a instalação dos componentes individuais **C++ Clang-cl for Windows** e **C++ Clang-cl for v142 build tools (x64/x86)**. Veja o tópico sobre Clang do [Microsoft Game Development Kit (GDK)](https://docs.xbox.com/pt-BR/tools/tools-pc/visualstudio/gr-vs-clang.md) e o [Microsoft Docs](https://learn.microsoft.com/cpp/build/clang-support-msbuild) para obter mais informações. ## 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) com o DirectXMath 3.14 ou posterior. Caso contrário, você pode contornar o problema colocando instruções `#pragma float_control` em torno do uso dessas funções. * O uso de cabeçalhos pré-compilados tem vários problemas no clang/LLVM for Windows anterior à v11. Dependendo do uso de PCH e de modelos C++, talvez seja necessário adicionar `-fno-pch-instantiate-templates` para compilar com êxito. * As [atualizações do .NET Core entregues pelo Microsoft Update](https://devblogs.microsoft.com/dotnet/net-core-updates-coming-to-microsoft-update/) podem bloquear a instalação do Microsoft Game Development Kit (GDK). Para resolver esse problema, atualize sua instância do Visual Studio ou desinstale o componente Microsoft.NET.Core.Component.SDK.2.1 pelo Instalador do Visual Studio e tente (des)instalar o Microsoft Game Development Kit (GDK) novamente. ## Relatar bugs Os relatórios de bugs do **compilador Visual C++** devem ser enviados (se possível) por meio de *Relatar um Problema...* no 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). Leia [esta página](https://aka.ms/compilerbug) para obter detalhes sobre como criar um bom relatório de bug para o compilador. > [!NOTE] > > Você pode adicionar um comentário marcado como "Microsoft only" a um relatório público se forem necessárias informações adicionais sob NDA para reproduzir o problema. Para relatar bugs do **compilador clang/LLVM for Windows**, use [https://bugs.llvm.org/](https://bugs.llvm.org/) Para relatar bugs da **Biblioteca Padrão C++ da Microsoft** (também conhecida como STL), use [https://github.com/microsoft/STL/issues](https://github.com/microsoft/STL/issues) ## Veja também [Visual Studio para o desenvolvimento de jogos para PC](https://docs.xbox.com/pt-BR/tools/tools-pc/visualstudio/gr-visualstudio-toc.md) ## Related topics - [Visual Studio (conteúdo)](https://docs.xbox.com/pt-BR/tools/tools-pc/visualstudio/gr-visualstudio-toc.md) - [Visualstudio](https://docs.xbox.com/pt-BR/tools/tools-pc/visualstudio/index.md) - [Visual Studio para desenvolvimento para console](https://docs.xbox.com/pt-BR/tools/tools-console/visualstudio/visualstudio.md) - [Notas de suporte do GDK para o Visual Studio 2019](https://docs.xbox.com/pt-BR/tools/tools-console/visualstudio/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)