> ## 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 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.</Note>

## 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.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_workloads_game_devlopment.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=4fb4b71036246e053fa20ee3270bb27b" alt="Captura de tela da caixa de diálogo da carga de trabalho Desenvolvimento de jogos com C++" width="403" height="84" data-path="images/gdk/tools/vs_workloads_game_devlopment.png" />

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**.

<img src="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" alt="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" width="669" height="371" data-path="images/gdk/tools/vs_convert_2017_to_2019.png" />

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}
      <PropertyGroup Label="Globals">
        <WindowsTargetPlatformVersion>10.0</WindowsTargetPlatformVersion>
        ...
```

1. Altere todas as instâncias de `PlatformToolset` de v141 para v142. Veja um exemplo a seguir.

```xml theme={null}
    <PlatformToolset>v141</PlatformToolset>
    ...
    <PlatformToolset>v142</PlatformToolset>  
```

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)](/pt-BR/tools/tools-pc/visualstudio/gr-vs-clang) 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.</Note>

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](/pt-BR/tools/tools-pc/visualstudio/gr-visualstudio-toc)


## Related topics

- [Visual Studio](/pt-BR/tools/tools-pc/visualstudio/index.md)
- [Visual Studio (conteúdo)](/pt-BR/tools/tools-pc/visualstudio/gr-visualstudio-toc.md)
- [Visual Studio para desenvolvimento para console](/pt-BR/tools/tools-console/visualstudio/visualstudio.md)
- [Notas de suporte do GDK para o Visual Studio 2019](/pt-BR/tools/tools-console/visualstudio/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)