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

Neste artigo, saiba como usar as Ferramentas do Visual Studio para o Unreal Engine para:

• Adicionar módulos do Mecanismo Unreal no Visual Studio
• Adicionar classes do Mecanismo Unreal 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 (17.11 versões prévias ok) ou posterior.
• Unreal Engine versão 5 ou posterior.
• Ferramentas do Visual Studio para o Mecanismo Unreal. Confira Instalar as Ferramentas do Visual Studio para a Unreal Engine para obter instruções de instalação.
• Conclua o Quickstart : Ferramentas do Visual Studio para Unreal Engine para baixar e criar o jogo Lyra e configurá-lo para usar as Ferramentas do Visual Studio para Unreal Engine.

Adicionar módulos do Unreal Engine no Visual Studio

Agora você pode adicionar módulos do Unreal Engine ao seu projeto Unreal Engine diretamente do Visual Studio. Você não precisa mais alternar entre o Editor do Mecanismo Unreal e o Visual Studio para adicionar um módulo ou precisa sincronizar a solução do Visual Studio com o arquivo de projeto do Mecanismo Unreal 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 autocontidas que podem ser carregadas e descarregadas em runtime. A criação de módulos pode ser entediante e propensa a erros se você fizer isso manualmente, pois isso 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 ao fornecer uma caixa de diálogo que orienta você durante o processo, além de configurar e adicionar o código padrão para você.

Para adicionar um módulo Unreal Engine no Visual Studio, siga estas etapas após concluir o Quickstart: Ferramentas do Visual Studio para Unreal Engine para baixar e compilar o jogo Lyra. Estas 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, onde você deseja que o novo módulo seja inserido.
2. Clique com o botão direito do mouse no projeto (certifique-se de que um projeto está selecionado e não uma pasta) e escolha Adicionar>item do Mecanismo Unreal... para abrir a caixa de diálogo Adicionar Novo Item para itens do Mecanismo Unreal:
3. Escolha Módulo do Unreal Engine, forneça um nome do módulo no campo Nome, e então 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 e listas suspensas para o tipo de módulo (com Runtime selecionado) e a fase de carregamento do módulo (Padrão está selecionado). Os caminhos de módulo, cabeçalho, origem e arquivo de build são listados. A caixa de seleção para atualizar informações do IntelliSense usando as ferramentas do Editor do Unreal 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 informações de configuração para o módulo.

Adicionar classes do Mecanismo Unreal no Visual Studio

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

Para adicionar uma classe unreal Engine no Visual Studio, siga estas etapas após concluir Início Rápido: Ferramentas do Visual Studio para 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. Em do Gerenciador de Soluções, escolha uma pasta para onde deseja que a nova classe vá. 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 Mecanismo Unreal... para abrir a caixa de diálogo Adicionar Novo Item:

   

   Ele tem opções para adicionar classes comuns do Mecanismo Unreal (que está selecionada), Módulo de Mecanismo Unreal Vazio e Plug-ins do Mecanismo Unreal.

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, Caractere e assim por diante, são visíveis. Há um campo para o nome da classe e uma lista suspensa para o módulo ao qual adicioná-la. Os caminhos para o arquivo de cabeçalho e o arquivo de origem são listados. Uma caixa de seleção é selecionada para atualizar as informações do IntelliSense usando as ferramentas do Editor do Unreal.

4. Escolha um nome de classe . O Visual Studio avisa se o nome está em conflito com uma classe ou arquivo existente.
5. Escolha uma classe base . Selecionar uma classe base garante que os cabeçalhos e macros certos sejam incluídos para esse tipo de classe.
6. Escolha um módulo para adicionar à sua classe usando a lista suspensa Selecionar um módulo para adicionar a classe. O nome do módulo é o nome da pasta que contém o módulo.
7. Selecione a caixa de seleção Atualizar informações do IntelliSense usando as ferramentas do Editor do Unreal para escolher se o Visual Studio usa ferramentas do Editor do Unreal para atualizar as informações do IntelliSense. Escolha isso para fazer com que a Ferramenta de Build do Unreal regenere o arquivo de solução do Visual Studio.
8. Escolha OK para gerar o cabeçalho e os arquivos 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. Para recarregar o projeto, escolha Recarregar.

Adicionar plug-ins do Unreal Engine no Visual Studio

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

Para adicionar um plug-in do Unreal Engine no Visual Studio, siga estas etapas depois de concluir Início Rápido: Ferramentas do Visual Studio para 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. Em do Gerenciador de Soluções, escolha uma pasta para onde você deseja que o novo plug-in vá. 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 Mecanismo Unreal... para abrir a caixa de diálogo Adicionar Novo Item:

   

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

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

   

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

4. Escolha o tipo de plug-in na lista Tipo de plug-in.
5. Forneça o nome do plug-in , o autor do plug-in , a descrição do plug-in e a url do plug-in .
6. Marque a caixa O plug-in está na versão beta, conforme necessário.
7. Selecione 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 para atualizar as informações do IntelliSense. Isso faz com que a Ferramenta de Build do Unreal regenere 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. Para recarregar o projeto, escolha Recarregar.

Conteúdo relacionado

Ferramentas do Visual Studio para Unreal Engine
Exibir Blueprints do Unreal Engine no Visual Studio
Exibir o log do Unreal Engine no Visual Studio
Visualizar macros do Unreal Engine no Visual Studio