Adicionar classes, módulos e plug-ins do Unreal Engine no Visual Studio

Neste artigo, saiba como usar o Visual Studio Tools for Unreal Engine para:

• Adicionar módulos do Unreal Engine no Visual Studio
• Adicionar classes do Unreal Engine no Visual Studio
• Adicionar plug-ins do Unreal Engine no Visual Studio

Pré-requisitos

O seguinte deve ser instalado:

• Visual Studio versão 17.11 (versões prévias 17.11 ok) ou versões posteriores.
• 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.

Adicionar módulos do Unreal Engine no Visual Studio

Agora você pode adicionar módulos do Unreal Engine ao seu projeto do Unreal Engine no Visual Studio. Você não precisa mais alternar entre o Unreal Engine Editor e o Visual Studio para adicionar um módulo ou sincronizar a solução do Visual Studio com o arquivo de projeto do Unreal Engine posteriormente.

Os módulos são uma maneira de organizar seu código no Unreal Engine. Eles ajudam você a agrupar classes e ativos relacionados e organizar seu código em unidades independentes que podem ser carregadas e descarregadas no runtime. A criação de módulos poderá ser tediosa e propensa a erros se você fizer isso manualmente, pois requer a edição de arquivos de configuração e a adição de código clichê. O Visual Studio facilita a criação de módulos, fornecendo uma caixa de diálogo que orienta você pelo processo, fazendo a configuração e adicionando o texto clichê automaticamente.

Para adicionar um módulo do Unreal Engine no Visual Studio, siga estas etapas depois de concluir o Início Rápido: Visual Studio Tools for Unreal Engine para baixar e criar o jogo Lyra. Essas etapas pressupõem que você tenha a solução LyraStarterGame.sln aberta no Visual Studio:

1. No Gerenciador de Soluções, escolha um projeto, como LyraStarterGame, para o qual você deseja migrar o novo módulo.
2. Clique com o botão direito do mouse no projeto (certifique-se de que um projeto esteja selecionado, e não uma pasta) e escolha Adicionar>item do Unreal Engine... para abrir a caixa de diálogo Adicionar Novo Item para itens do Unreal Engine:
3. Escolha Módulo do Unreal Engine, forneça um nome de módulo no campo Nome e escolha Adicionar para abrir a caixa de diálogo Adicionar Módulo do Unreal Engine:

   

   A caixa de diálogo Adicionar Módulo do Unreal Engine tem um campo para o nome do Módulo, menus suspensos para o tipo de Módulo (runtime é selecionado) e fase de carregamento do módulo (o padrão é selecionado). O caminho do módulo, o cabeçalho, a origem e os caminhos do arquivo de compilação são listados. A caixa de seleção para Atualizar informações do IntelliSense usando as ferramentas do Unreal Editor está marcada.

4. Use os menus suspensos para selecionar o Tipo de módulo e a Fase de carregamento do módulo.
5. Escolha OK para adicionar o módulo ao projeto e atualizar o arquivo de solução do Visual Studio.

Os módulos só podem ser criados na pasta Source ou como um módulo de um plugin dentro da pasta Plugins.
O caminho de compilação mostra onde o arquivo Build.cs é criado. O arquivo Build.cs contém as informações de configuração necessárias para o módulo.

Adicionar classes do Unreal Engine no Visual Studio

Agora você pode adicionar classes do Unreal Engine ao seu projeto do Unreal Engine no Visual Studio. Você não precisa mais alternar entre o Unreal Editor e o Visual Studio para adicionar uma classe ou sincronizar a solução do Visual Studio com o arquivo de projeto do Unreal Engine posteriormente.

Para adicionar uma classe do Unreal Engine no Visual Studio, siga estas etapas depois de concluir o Início Rápido: Visual Studio Tools for Unreal Engine para baixar e criar o jogo Lyra. As etapas pressupõem que você tenha a solução LyraStarterGame.sln aberta no Visual Studio:

1. No Gerenciador de Soluções, escolha uma pasta para a qual você deseja migrar a nova classe. No projeto LyraStarterGame, você pode adicionar uma nova classe à pasta LyraStarterGame>Source, por exemplo.
2. Clique com o botão direito do mouse na pasta e escolha Adicionar>item do Unreal Engine... para abrir a caixa de diálogo Adicionar Novo Item:

   

   Ela tem opções para adicionar Classes Comuns do Unreal Engine (que está selecionada), Módulo Vazio do Unreal Engine e Plug-ins do Unreal Engine.

3. Escolha Classes Comuns do Unreal Engine e, em seguida, escolha Adicionar para abrir a caixa de diálogo Adicionar Classe do Unreal Engine:

   

   As opções para selecionar uma base, como Ator, Personagem e assim por diante, são visíveis. Há um campo para o nome da classe e um menu suspenso para o módulo ao qual adicionar a classe. Os caminhos para o arquivo de cabeçalho e o arquivo de origem são listados. Uma caixa de seleção é marcada para atualizar as informações do IntelliSense usando as ferramentas do Unreal Editor.

4. Escolha um Nome de classe. O Visual Studio avisa se o nome entrar em conflito com uma classe ou arquivo existente.
5. Escolha uma Classe de base. A seleção de uma classe de base garante que os cabeçalhos e macros corretos sejam incluídos para esse tipo de classe.
6. Escolha um módulo para adicionar à sua classe usando o menu suspenso Selecionar um módulo para adicionar a classe. O nome do módulo é o nome da pasta que contém o módulo.
7. Marque a caixa de seleção Atualizar informações do IntelliSense usando as ferramentas do Unreal Editor para escolher se o Visual Studio usa as ferramentas do Unreal Editor a fim de atualizar as informações do IntelliSense. Escolha essa opção para fazer com que a Ferramenta de Compilação do Unreal gere novamente o arquivo de solução do Visual Studio.
8. Escolha OK para gerar os arquivos de cabeçalho e de origem para a nova classe e adicioná-los ao arquivo de solução do Visual Studio. Isso resulta em um prompt para recarregar o projeto. Escolha Recarregar para recarregar o projeto.

Adicionar plug-ins do Unreal Engine no Visual Studio

Agora você pode adicionar plug-ins do Unreal Engine ao seu projeto do Unreal Engine no Visual Studio. Você não precisa mais alternar entre o Unreal Editor e o Visual Studio para adicionar um plugin ou sincronizar a solução do Visual Studio com o arquivo de projeto do Unreal Engine posteriormente.

Para adicionar um plug-in do Unreal Engine no Visual Studio, siga estas etapas depois de concluir o Início Rápido: Visual Studio Tools for Unreal Engine para baixar e criar o jogo Lyra. As etapas pressupõem que você tenha a solução LyraStarterGame.sln aberta no Visual Studio:

1. No Gerenciador de Soluções, escolha uma pasta para a qual você deseja migrar o novo plugin. No projeto LyraStarterGame, você pode adicionar um novo plug-in à pasta LyraStarterGame>Source, por exemplo.
2. Clique com o botão direito do mouse na pasta e escolha Adicionar>item do Unreal Engine... para abrir a caixa de diálogo Adicionar Novo Item:

   

   Ela tem opções para adicionar Classes Comuns do Unreal Engine, Módulo Vazio do Unreal Engine e Plug-ins do Unreal Engine (que está selecionada).

3. Escolha Plug-ins do Unreal Engine e, em seguida, escolha Adicionar para abrir a caixa de diálogo Adicionar Plug-in do Unreal Engine:

   

   Há uma lista de tipos de Plug-in (Avançado está selecionado) e campos para o nome, caminho, autor, descrição e URL do plug-in. Há uma caixa de seleção É plug-in na versão beta (desmarcada) e uma caixa de seleção Atualizar informações do IntelliSense usando as Ferramentas do Unreal Editor (marcada).

4. Escolha o tipo de plug-in na lista Tipo de plug-in.
5. Forneça o nome do plug-in, autor do plug-in, a descrição do plug-in e o URL do plug-in.
6. Marque a caixa É plug-in na versão beta conforme necessário.
7. Marque a caixa de seleção Atualizar informações do IntelliSense usando as ferramentas do Unreal Editor para escolher se o Visual Studio usa as ferramentas do Unreal Editor a fim de atualizar as informações do IntelliSense. Isso faz com que a Ferramenta de Compilação do Unreal gere novamente o arquivo de solução do Visual Studio.
8. Escolha Adicionar para gerar o cabeçalho do plug-in e os arquivos de origem para o novo plug-in e adicioná-los ao arquivo de solução do Visual Studio. Isso resulta em um prompt para recarregar o projeto. Escolha Recarregar para recarregar o projeto.

Conteúdo relacionado

Visual Studio Tools for Unreal Engine
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