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.
- 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 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.
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.- Adicione
WindowsTargetPlatformVersionao grupo de propriedadesGlobals. Defina o valor como 10.0. Veja um exemplo a seguir.
- Altere todas as instâncias de
PlatformToolsetde v141 para v142. Veja um exemplo a seguir.
- 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) e o Microsoft Docs 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_controlem 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-templatespara compilar com êxito. - As atualizações do .NET Core entregues pelo 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 e o site da Developer Community. Leia esta página para obter detalhes sobre como criar um bom relatório de bug para o compilador.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.