Exibir macros do Unreal Engine no Visual Studio

Artigo
08/01/2024

Você pode usar o Visual Studio Tools for Unreal Engine (UE) para ver o registro em log da UE no Visual Studio. Isso é útil porque você pode ver o registro em log da UE sem precisar alternar entre o Editor do Unreal e o Visual Studio.

Pré-requisitos

Instale o seguinte:

Visual Studio versão 17.10 ou posterior.
Unreal Engine versão 5 ou posterior.
Visual Studio Tools for Unreal Engine. Consulte Instalar o Visual Studio Tools for Unreal Engine para obter instruções de instalação.
Conclua o Início Rápido: Visual Studio Tools for Unreal Engine para baixar e compilar o jogo Lyra e configurá-lo para usar o Visual Studio Tools for Unreal Engine.

Exibir macros do Unreal Engine no Visual Studio

Macros UE longas podem ser difíceis de ler. o Visual Studio Tools for Unreal Engine expandem as macros da UE para que você possa lê-las com mais facilidade. Você pode copiar a macro expandida, se desejar. Você também pode pesquisá-la online ou compará-la com outra macro. Para experimentar esses recursos, siga estas etapas depois de concluir o Início Rápido: Visual Studio Tools for Unreal Engine para baixar e criar o jogo Lyra.

No Visual Studio, abra LyraGameplayAbility_RangedWeapon.cpp. Pesquise esse arquivo no painel Pesquisa do Gerenciador de Soluções ou localize-o em Games>LyraStarterGame>Source>LyraGame>Weapons>LyraGameplayAbility_RangedWeapon.cpp
Em LyraGameplayAbility_RangedWeapon.cpp, vá para a linha 41. Você deverá ver a seguinte macro: UE_DEFINE_GAMEPLAY_TAG_STATIC(TAG_WeaponFireBlocked, "Ability.Weapon.NoFiring");
Passe o ponteiro do mouse sobre UE_DEFINE_GAMEPLAY_TAG_STATIC para ver a janela de definição de macro: As opções na parte inferior copiam a macro para a área de transferência, expandem a macro embutida, visualizam a expansão da macro e pesquisam online pela macro.
Escolha Expandir Embutido, para expandir a macro e todas as macros aninhadas, na janela de código. Você pode pressionar Ctrl+z para desfazer a expansão.
Escolha Pesquisar online para abrir seu navegador. Ela se abre com uma pesquisa preenchida para localizar a macro. No exemplo anterior, isso abre o navegador para pesquisar C++ #define UE_DEFINE_GAMEPLAY_TAG_STATIC(TagName, Tag) static FNativeGameplayTag TagName(UE_PLUGIN_NAME, UE_MODULE_NAME, …
Escolha Visualizar a expansão para abrir a janela Expansão da Macro. Você pode expandir as macros aninhadas que fazem parte da macro maior uma etapa de cada vez. Role até o final da expansão para ver as setas de expansão da macro no canto superior direito da janela. Escolha a seta para a direita para expandir a próxima macro aninhada. Escolha a seta para a esquerda para recolher a última macro aninhada que foi expandida: