Guia de início rápido: Visual Studio Tools for Unreal Engine

Neste quickstart, descarregas um exemplo de jogo do Unreal Engine (UE) e configuras o Visual Studio Tools para o Unreal Engine. O Visual Studio Tools for Unreal Engine é uma extensão gratuita que ajuda você a desenvolver jogos com o Unreal Engine. Ele fornece recursos que melhoram a experiência de desenvolvimento do Unreal Engine no Visual Studio.

Pré-requisitos

O seguinte deve ser instalado:

• Visual Studio versão 17.10 ou posterior.
• Unreal Engine versão 5 ou posterior porque o exemplo usado neste artigo requer Unreal Engine 5 ou posterior.
• Ferramentas do Visual Studio para Unreal Engine. Consulte Instalar o Visual Studio Tools for Unreal Engine para obter instruções de instalação.

Lyra é um projeto de jogo de amostra para aprender sobre Unreal Engine. Para instruções de download, consulte a secção Como Descarregar o Jogo Inicial Lyra em Lyra Sample Game. Se adquiriste o projeto Lyra através da instalação do código-fonte do Unreal Engine, essa versão não contém os recursos necessários para construir e correr o jogo. Usa as instruções de download para obteres tudo o que precisas.

Se tiver o Visual Studio 2022 versão 17.11 ou anterior, deve gerar o ficheiro da solução Visual Studio no Unreal Engine antes de poder abrir o projeto no Visual Studio. Este é o cenário que este artigo aborda.

Configure Lyra para usar Visual Studio Tools para o Unreal Engine

Se tiver o Visual Studio 2022 17.11 ou anterior, deve ativar o plugin Visual Studio Tools for Unreal Engine no projeto Lyra para usar as funcionalidades do Visual Studio Tools para o Unreal Engine. Depois de descarregares o exemplo do jogo Lyra, atualiza LyraStarterGame.uproject para usar o plugin Visual Studio Tools. Pode fazer isto a partir do Unreal Editor ou editando manualmente o LyraStarterGame.uproject ficheiro.

Método 1: Ativar o plugin Visual Studio Integration Tools no Unreal Editor

1. No Editor Unreal, carrega o projeto Lyra.
2. No menu principal do Visual Studio escolhe Editar>Plugins.
3. Encontre o plug-in Ferramentas de Integração do Visual Studio e marque a caixa ao lado dele.

Método 2: editar o ficheiro do projeto

1. Abra o arquivo LyraStarterGame.uproject em um editor de texto. Está no diretório onde você instalou o exemplo de jogo.

2. Adicione o seguinte ao final da Plugins seção:

   ,{
       "Name": "VisualStudioTools",
       "Enabled": true
   }
   

Construir o projeto Lyra no Visual Studio

Antes de construir o projeto Lyra no Visual Studio:

1. Abra o projeto Lyra no Unreal Engine.
2. No menu principal do editor do Unreal Engine, escolha Ferramentas>para gerar projeto do Visual Studio. Isso cria o arquivo de solução para o Visual Studio.
3. No menu principal do editor do Unreal Engine, escolha Ferramentas>Abrir o Visual Studio para abrir o jogo no Visual Studio. Se você tiver várias versões do Visual Studio em sua máquina, verifique se a versão correta foi aberta: no menu principal do Visual Studio, escolha Ajuda>sobre o Microsoft Visual Studio. Deve usar o Visual Studio 2022 versão 17.7 ou superior. Se a versão correta não abrir, abra LyraStarterGame.sln manualmente na versão correta do Visual Studio.

No Visual Studio

1. Altere a lista suspensa Configurações de soluções para Editor de desenvolvimento. Isso habilita o Blueprints Visual Studio Tools for Unreal Engine:
2. Defina o projeto de inicialização como o projeto LyraStarterGame . No Gerenciador de Soluções, clique com o botão direito do mouse na solução e escolha Propriedades.
3. Na caixa de diálogo Páginas de Propriedades da Solução , em Propriedades Comuns, escolha Configurar Projetos de Inicialização.
4. Certifique-se de que o projeto de inicialização única está selecionado e escolha LyraStarterGame no menu suspenso.

   

   Em Propriedades comuns, Configurar projetos de inicialização está selecionado. O botão de opção de projeto de inicialização único é selecionado. O projeto de inicialização no menu suspenso é LyraStarterGame.

5. Escolha OK para fechar a caixa de diálogo.
6. No menu principal do Visual Studio, escolha Build>Build Solution para criar o jogo.

Janela de saída de compilação do Visual Studio

A janela de saída de compilação no Visual Studio mostra o progresso da compilação e quaisquer erros ou avisos que ocorram. Você pode abrir a janela de saída de compilação no menu principal do Visual Studio por meio de View>Output.

A partir do Visual Studio 2022 17.12, você pode clicar duas vezes em um caminho absoluto para um arquivo na janela de saída para abrir esse arquivo no Visual Studio. O código-fonte deve fazer parte da solução Visual Studio e o caminho na janela de saída deve ser um caminho absoluto. Isso funciona ao criar projetos Unreal Engine no Visual Studio ou outros tipos de projetos.

A captura de tela a seguir mostra a janela de saída para uma compilação do exemplo LyraStarterGame. O usuário clicou duas vezes em um aviso de LyraCharacter.generated.h. Como o caminho absoluto para esse arquivo é fornecido, o arquivo é aberto no editor.

Barra de ferramentas Unreal Engine

O Visual Studio fornece uma barra de ferramentas que melhora a experiência de integração de desenvolvimento do Unreal Engine no Visual Studio. A barra de ferramentas fornece acesso rápido a tarefas comuns da UE.

Ative a barra de ferramentas Unreal Engine no Visual Studio no menu principal por meio de View>Toolbars>Unreal Engine. A barra de ferramentas tem a seguinte aparência:

Os botões da barra de ferramentas, da esquerda para a direita:

• O ícone de reprodução é um botão de conexão rápida que se anexa aos processos listados na lista suspensa à direita. A lista suspensa lista os processos relacionados ao Unreal Engine, o que facilita a conexão ao Unreal Engine Editor mais facilmente. Você também pode usar isso para anexar a quaisquer processos.
• Botões para iniciar e parar o servidor de integração Unreal Engine. O servidor de integração melhora o desempenho da integração do Unreal Engine com o Visual Studio. Ele é executado como um processo em segundo plano e atualiza automaticamente as informações de teste à medida que você trabalha em seu projeto. Você pode desativá-lo para recuperar recursos da máquina e iniciá-lo quando quiser as melhorias de integração. O servidor é iniciado automaticamente quando você abre um projeto UE no Visual Studio.
• Um botão para verificar novamente os ativos do Unreal Engine Blueprint. Isso atualiza a solução Visual Studio com os ativos Blueprint mais recentes do projeto Unreal Engine.
• Um botão que abre a janela de log do Unreal Engine.
• Um botão para abrir a janela Configuração de integração do Unreal Engine onde você pode atualizar e ver o status geral da configuração e o status da Ferramenta de Integração do Visual Studio, verificar se há suporte ao Blueprint, ver se obtém o status do verificador de convenção de nomenclatura do Unreal Engine e assim por diante.

Lista suspensa de argumentos de linha de comando

Você pode iniciar seu jogo com frequência com diferentes combinações de argumentos de linha de comando durante a parte de edição e depuração do loop interno. Isso agora é mais fácil com a lista suspensa de argumentos de linha de comando:

Para adicionar argumentos de linha de comando, digite-os na lista suspensa e pressione Enter. Os argumentos são salvos na ordem em que você os insere e aparecem na lista suspensa para uso futuro.

Há um limite de cinco linhas de comando que você pode adicionar antes que a mais antiga seja removida para abrir espaço para uma nova. Quando você carrega o Unreal Engine pela primeira vez, os argumentos padrão aparecem na lista suspensa.

O primeiro argumento ao depurar um projeto Unreal Engine que é executado no editor Unreal Engine deve ser o caminho para o projeto. Por exemplo: C:\UE\LyraStarterGame\LyraStarterGame.uproject.

Para obter mais informações sobre como usar a lista suspensa de argumentos de linha de comando, consulte Passar argumentos de linha de comando.

Próximos passos

Adicionar classes, módulos e plug-ins do Unreal Engine no Visual Studio
Exibir plantas do Unreal Engine no Visual Studio
Exibir o log do Unreal Engine no Visual Studio
Exibir macros do Unreal Engine no Visual Studio