Compartilhar via


Início Rápido: Visual Studio Tools for Unreal Engine

Neste artigo, baixe um exemplo de jogo do Unreal Engine (UE) e configure o Visual Studio Tools for 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 o Unreal Engine 5 ou posterior.
  • Visual Studio Tools for Unreal Engine. Consulte Instalar Visual Studio Tools for Unreal Engine para obter instruções de instalação.

Baixar e construir o exemplo de jogo Lyra no Visual Studio

Lyra é um exemplo de projeto de jogo para aprender sobre o Unreal Engine. Consulte a seção Como baixar o jogo Lyra de início em Amostra de jogo para obter instruções de download. Se você o adquiriu por meio da instalação do código-fonte do Unreal Engine, essa versão não contém os recursos necessários para criar e executar o jogo. Use as instruções de download para obter tudo o que você precisa por meio do instalador da Epic.

Configurar o exemplo de jogo do Lyra para usar o Visual Studio Tools for Unreal Engine

A partir do Visual Studio 2022 versão 17.7, o plug-in Visual Studio Tools for Unreal Engine está incluído na instalação do Unreal Engine. Não é mais necessário visualizar os Blueprints do Unreal Engine. Se você usar uma versão anterior do Visual Studio, consulte Instalar as ferramentas do Visual Studio para Unreal Engine para instalar o plug-in manualmente.

Depois de baixar o exemplo de jogo, atualize LyraStarterGame.uproject para usar o plug-in do Visual Studio Tools. Uma maneira de fazer isso é no Unreal Editor. Carregue o projeto Lyra e, no menu principal, escolha Editar>Plug-ins. Localize o plug-in Ferramentas de Integração do Visual Studio e marque a caixa ao lado dele.

Outra maneira de fazer isso é editar manualmente o arquivo LyraStarterGame.uproject. Este é o procedimento:

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

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

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

No Unreal Engine

  1. Abra o projeto Lyra na Unreal Engine.
  2. No menu principal do editor do Unreal Engine, escolha Ferramentas>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 Visual Studio para abrir o jogo no Visual Studio. Se você tiver várias versões do Visual Studio em seu computador, verifique se a versão certa foi aberta: no menu principal do Visual Studio, escolha Ajuda>Sobre o Microsoft Visual Studio. Você precisa usar o Visual Studio 2022 versão 17.7 ou superior. Se a versão certa não abriu, 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 o Editor de Desenvolvimento. Isso habilita os Blueprints Visual Studio Tools for Unreal Engine: Captura de tela do Visual Studio com a lista suspensa Configurações de Soluções expandida e o Editor de Desenvolvimento selecionado.
  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. No diálogo Páginas de Propriedades da Solução, em Propriedades Comuns, escolha Configurar Projetos de Inicialização.
  4. Certifique-se de que Projeto de inicialização único esteja selecionado e escolha LyraStarterGame no menu suspenso.

    Uma captura de tela do diálogo Páginas de propriedades da solução.

    Em Propriedades Comuns, Configurar Projetos de Inicialização está selecionado. O botão de opção de projeto de inicialização única está selecionado. O projeto de inicialização no menu suspenso é LyraStarterGame.

  5. Escolha OK para fechar o diálogo.
  6. No menu principal do Visual Studio, escolha Criar>Criar solução para criar o jogo.

Janela de saída de build do Visual Studio

A janela de saída de build no Visual Studio mostra o progresso do build e eventuais erros ou avisos. Você pode abrir a janela de saída de build no menu principal do Visual Studio via Exibir>Saída.

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 do Visual Studio, e o caminho na janela de saída deve ser um caminho absoluto. Isso funciona na criação de projetos do Unreal Engine no Visual Studio ou em outros tipos de projetos.

A captura de tela a seguir mostra a janela de saída para um build 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.

Uma captura de tela da janela de saída do Visual Studio. O arquivo LyraCharacter.generated.h fica realçado porque o caminho absoluto é especificado, e o usuário clicou duas vezes nele para abrir o arquivo LyrCharacter.generated.h.

Barra de ferramentas do 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 do UE.

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

Uma captura de tela da barra de ferramentas do Unreal Engine no Visual Studio.

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

  • O ícone de reprodução é um botão de anexação rápida que se conecta aos processos listados no menu suspenso à direita. O menu suspenso lista os processos relacionados ao Unreal Engine, o que facilita a conexão ao Unreal Engine Editor com mais facilidade. Você também pode usar isso para anexar a qualquer processo.
  • Botões para iniciar e parar o servidor de integração do 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 no seu projeto. Você pode desativá-lo para recuperar os recursos da máquina e iniciá-lo quando quiser as melhorias de integração. O servidor é iniciado automaticamente quando você abre um projeto do UE no Visual Studio.
  • Um botão para verificar novamente os ativos de Blueprint do Unreal Engine. Isso atualiza a solução do Visual Studio com os ativos mais recentes de Blueprint do projeto do 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 o suporte ao Blueprint, conferir o status do verificador da 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:

Uma captura de tela da lista suspensa de argumentos de linha de comando.

A lista suspensa de argumentos de linha de comando é mostrada após a lista suspensa Plataformas de soluções na barra de ferramentas Padrão. Há uma entrada para C:\UE\LyraStarterGame\LyraStarterGame.uproject -fullscreen e C:\UE\LyraStarterGame\LyraStarterGame.uproject -JsonDebugOutput.

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.

O primeiro argumento ao depurar um projeto do Unreal Engine que é executado no editor do 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 durante a depuração (C++).

Próximas etapas

Adicionar classes, módulos e plug-ins do Unreal Engine no Visual Studio
Exibir blueprints do Unreal Engine no Visual Studio
Exibir registro em log do Unreal Engine no Visual Studio
Exibir macros do Unreal Engine no Visual Studio