A Unreal Engine (UE) foi projetada para se integrar perfeitamente ao Visual Studio (VS), fornecendo os meios para fazer alterações de código em seus projetos com rapidez e ver os resultados imediatamente após a compilação. Configurar o VS para funcionar com a UE pode ajudar a melhorar a eficiência dos desenvolvedores e a experiência geral do usuário.
Este documento aborda o básico para configurar seu fluxo de trabalho Unreal Engine para Visual Studio.
Compatibilidade de versões
A tabela a seguir lista quais versões do VS estão integradas à versão binária da UE.
| versão da Unreal Engine | Versão 2019 do VS | Versão 2022 do VS |
|---|---|---|
5.6 | Incompatível | 17.8 ou mais recente, 17.14 é recomendada (padrão) |
5.5 | Incompatível | 17.8 ou mais recente, 17.10 é recomendada (padrão) |
5.4 | Incompatível | 17.4 ou mais recente, 17.8 é recomendada (padrão) |
5.3 | 16.11.5 ou mais recente | 17.4 ou mais recente, 17.6 é recomendada (padrão) |
5.2 | 16.11.5 ou mais recente | 17.4 ou mais recente (padrão) |
5.1 | 16.11.5 ou mais recente (padrão) | 17.4 ou mais recente |
Outras versões do software:
| Software | Versão mínima | Versão recomendada |
|---|---|---|
MSVC | 14.38.33130 | 14.38.33130 |
SDK do Windows | 10.0.19041.0 | 10.0.22621.0 ou mais recente |
LLVM | 18.1.3 | 18.1.8 |
.NET | .NET 8.0 | .NET 8.0 |
Como verificar os pré-requisitos da UE
Se você instalou a UE do Inicializador da Epic Games ou a clonou do GitHub, o Instalador de Pré-requisitos da UE instalou automaticamente as dependências, bibliotecas e frameworks necessários para executar a engine.
Se você instalou ou sincronizou a UE do Perforce, execute o Instalador de Pré-requisitos antes de executar qualquer ferramenta da UE que você criou localmente. Localize o instalador em [UNREAL_ENGINE_ROOT]\Engine\Extras\Redist\en-us\.
Como adicionar opções de instalação do Visual Studio
Se estiver instalando o Visual Studio (VS) pela primeira vez ou modificando uma instalação existente, verifique se as cargas de trabalho e os componentes a seguir estão habilitados.
Para modificar sua instalação do Visual Studio, execute o Instalador do Visual Studio e clique em Modificar ao lado da versão mais recente.
Como adicionar cargas de trabalho necessárias
Na aba Cargas de trabalho do instalador, em Desktop e dispositivos móveis, habilite as seguintes opções:
Desenvolvimento para desktop com .NET
Desenvolvimento para desktop com C++
Desenvolvimento de interface de usuário de aplicativo multiplataforma .NET
Em Jogos, habilite Desenvolvimento de jogos com C++.
Como adicionar os componentes necessários
No painel Destalhes da Instalação, expanda Desenvolvimento de jogos com C++ e habilite as seguintes opções:
Ferramentas de perfil C++
AddressSanitizer C++
Windows 10 ou 11 SDK (10.0.18362 ou mais recente)
Instalador da Unreal Engine
Ao abrir seu primeiro projeto C++ da Unreal Engine em VS, você pode ver um aviso de componentes ausentes no Explorador de Soluções. Clique em Instalar para permitir que o VS instale os componentes adicionais necessários para o projeto.
Configurações recomendadas
Esses ajustes opcionais na interface do VS podem tornar sua experiência de desenvolvimento mais conveniente.
Como desativar a janela da lista de erros
Em geral, a janela Lista de Erros é aberta automaticamente quando há um erro no código. No entanto, ao trabalhar com a UE, a janela Lista de Erros pode exibir erros posteriores adicionais que dificultam a identificação da causa raiz . Você pode desabilitar a janela Lista de Erros e usar o Log de Saída para ver erros de código reais ao trabalhar com a UE.
Para desativar a janela Lista de Erros, siga estas etapas:
No VS, vá para Ferramentas > Opções.
À esquerda da janela Opções, selecione a janela Projetos e Soluções.
Desabilite Sempre mostrar a listas de erros se a compilação for concluída com erros.
(Opcional) Altere outras opções e funcionalidades da tabela abaixo que sejam relevantes ao projeto.
Clique em Ok.
| Para: | Em Opções, vá para: | E altere esta opção: |
|---|---|---|
Evite que partes de código fiquem acinzentadas no editor de texto | Editor de Texto > C/C++ > Visualização | Defina Mostar blocos inativos como falso |
Oculte pastas desnecessárias no Explorador de Soluções | Editor de Texto > C/C++ > Avançado | Defina Desabilitar pastas de dependências externas como Verdadeiro |
Habilite o IntelliSense (preenchimento de código, sugestões e formatação automática de código enquanto você escreve) | Editor de Texto > C/C++ > IntelliSense | Ative o IntelliSense de 64 bits |
Como aumentar a largura do menu suspenso Configurações de Solução
Pode ser útil ampliar o menu suspenso Configurações de Solução na barra de ferramentas do VS para visualizar o nome completo de quaisquer configurações personalizadas.
Para expandir o menu Configurações de Solução, siga estas etapas:
No Visual Studio, clique com o botão direito na barra de ferramentas principal e selecione Personalizar na parte inferior do menu de contexto.
Na janela Personalizar, clique na aba Comandos, selecione o botão de opção Barra de ferramentas e use o menu suspenso para alterar a barra de ferramentas para Padrão.
Na barra de ferramentas Pré-visualização, percorra as opções para localizar e selecionar Configurações de Solução e clique em Modificar seleção.
Altere a largura para 200 e clique em OK. O VS atualiza a barra de ferramentas com o novo tamanho.
Fecha a janela Personalizar.
Como adicionar o menu suspenso Plataformas de Solução
Ao desenvolver para várias plataformas, é conveniente ter o menu suspenso Plataformas de Solução na barra de ferramentas do VS.
Caso não veja esse menu à direita do menu suspenso Configurações de Solução, você pode adicioná-lo à barra de ferramentas clicando no pequeno botão de seta à direita da barra de ferramentas Padrão, vá em Adicionar ou remover botões e selecione Plataformas de Solução.
