Compartir a través de


Adición de clases, módulos y complementos de Unreal Engine en Visual Studio

En este artículo, obtendrá información sobre cómo usar Visual Studio Tools para Unreal Engine para realizar las siguientes tareas:

Requisitos previos

Se debe instalar lo siguiente:

Adición de módulos de Unreal Engine en Visual Studio

Ahora puede agregar módulos de Unreal Engine al proyecto de Unreal Engine desde Visual Studio. Ya no tiene que cambiar entre el Editor de Unreal Engine y Visual Studio para agregar un módulo ni es necesario sincronizar la solución de Visual Studio con el archivo de proyecto de Unreal Engine después.

Los módulos son una manera de organizar el código en Unreal Engine. Ayudan a agrupar clases y recursos relacionados y a organizar el código en unidades independientes que se pueden cargar y descargar en tiempo de ejecución. La creación de módulos puede ser tediosa y propensa a errores si se hace manualmente, ya que requiere editar archivos de configuración y añadir código reutilizable. Visual Studio facilita la creación de módulos proporcionando un cuadro de diálogo que le guía por el proceso y realizando la configuración y agregando los elementos reutilizables.

Para agregar un módulo de Unreal Engine en Visual Studio, siga estos pasos después de completar Inicio rápido: Visual Studio Tools para Unreal Engine para descargar y compilar el juego de Lyra. En estos pasos se supone que tiene la solución LyraStarterGame.sln abierta en Visual Studio:

  1. En el Explorador de soluciones, elija un proyecto, como LyraStarterGame, donde desea que vaya el nuevo módulo.
  2. Haga clic con el botón derecho en el proyecto (asegúrese de que un proyecto está seleccionado y no una carpeta) y elija Agregar>Elemento de Unreal Engine... para abrir el cuadro de diálogo Agregar nuevo elemento para los elementos de Unreal Engine: Captura de pantalla del menú Agregar nuevo elemento. Se ha seleccionado el módulo Unreal Engine vacío.
  3. Elija Módulo de Unreal Engine, proporcione un nombre de módulo en el campo Nombre y, a continuación, elija Agregar para abrir el cuadro de diálogo Agregar módulo de Unreal Engine:

    Captura de pantalla del cuadro de diálogo Agregar módulo de Unreal Engine.

    El cuadro de diálogo Agregar módulo de Unreal Engine tiene un campo para el nombre del módulo, listas desplegables para el tipo de módulo (Runtime está seleccionado) y la fase de carga del módulo (el valor predeterminado está seleccionado). Se muestran las rutas de acceso al módulo, encabezado, origen y archivo de compilación. La casilla Actualizar información de IntelliSense mediante herramientas del Editor de Unreal está activada.

  4. Use las listas desplegables para seleccionar el tipo de módulo y la fase de carga del módulo.
  5. Elija Aceptar para agregar el módulo al proyecto y actualizar el archivo de solución de Visual Studio.

Los módulos solo se pueden crear en la carpeta Origen o como módulo de un complemento dentro de la carpeta Complementos.
La ruta de compilación muestra dónde se crea el archivo Build.cs. El archivo Build.cs contiene información de configuración para el módulo.

Adición de clases de Unreal Engine en Visual Studio

Ahora puede agregar clases de Unreal Engine al proyecto de Unreal Engine desde Visual Studio. Ya no tiene que cambiar entre el Editor de Unreal Engine y Visual Studio para agregar una clase ni es necesario sincronizar la solución de Visual Studio con el archivo de proyecto de Unreal Engine después.

Para agregar una clase de Unreal Engine en Visual Studio, siga estos pasos después de completar Inicio rápido: Visual Studio Tools para Unreal Engine para descargar y compilar el juego de Lyra. En estos pasos se supone que tiene la solución LyraStarterGame.sln abierta en Visual Studio:

  1. En el Explorador de soluciones, elija una carpeta donde quiera que vaya la nueva clase. En el proyecto LyraStarterGame, podría agregar una nueva clase a la carpeta LyraStarterGame>Origen, por ejemplo.
  2. Haga clic con el botón derecho en la carpeta y elija Agregar>Elemento de Unreal Engine... para abrir el cuadro de diálogo Agregar nuevo elemento:

    Una captura de pantalla del cuadro de diálogo Agregar nuevo elemento, con las clases comunes de Unreal Engine seleccionadas.

    Tiene opciones para agregar clases comunes de Unreal Engine (que está seleccionada), Módulo de Unreal Engine vacío y Complementos de Unreal Engine.

  3. Elija Clases comunes de Unreal Engine y, a continuación, elija Agregar para abrir el cuadro de diálogo Agregar clase de Unreal Engine:

    Captura de pantalla del cuadro de diálogo Agregar nueva clase de Unreal Engine.

    Las opciones para seleccionar una base como Actor, Personaje, etc., están visibles. Hay un campo para el nombre de la clase y una lista desplegable para el módulo al que agregar la clase. Se muestran las rutas de acceso al archivo de encabezado y de origen. Se ha seleccionado una casilla para actualizar la información de IntelliSense mediante herramientas del Editor de Unreal.

  4. Elija un nombre de clase. Visual Studio le advierte si el nombre entra en conflicto con una clase o archivo existente.
  5. Elija una clase base. Seleccionar una clase base garantiza que los encabezados y macros correctos se incluyan para ese tipo de clase.
  6. Elija un módulo al que agregar la clase mediante la lista desplegable Seleccionar un módulo para agregar la clase. El nombre del módulo es el nombre de la carpeta que contiene el módulo.
  7. Active la casilla Actualizar información de IntelliSense mediante herramientas del Editor de Unreal para elegir si Visual Studio debe usar las herramientas del Editor de Unreal para actualizar la información de IntelliSense. Elija esta opción para que la herramienta de compilación de Unreal vuelva a generar el archivo de solución de Visual Studio.
  8. Elija Aceptar para generar los archivos de encabezado y origen de la nueva clase y agréguelos al archivo de solución de Visual Studio. Esto da como resultado un mensaje para volver a cargar el proyecto. Elija Recargar para volver a cargar el proyecto.

Adición de complementos de Unreal Engine en Visual Studio

Ahora puede agregar complementos de Unreal Engine al proyecto de Unreal Engine desde Visual Studio. Ya no tiene que cambiar entre el Editor de Unreal Engine y Visual Studio para agregar un complemento ni es necesario sincronizar la solución de Visual Studio con el archivo de proyecto de Unreal Engine después.

Para agregar un complemento de Unreal Engine en Visual Studio, siga estos pasos después de completar Inicio rápido: Visual Studio Tools para Unreal Engine para descargar y compilar el juego de Lyra. En estos pasos se supone que tiene la solución LyraStarterGame.sln abierta en Visual Studio:

  1. En el Explorador de soluciones, elija una carpeta donde quiera que vaya el nuevo complemento. En el proyecto LyraStarterGame, podría agregar un nuevo complemento a la carpeta LyraStarterGame>Origen, por ejemplo.
  2. Haga clic con el botón derecho en la carpeta y elija Agregar>Elemento de Unreal Engine... para abrir el cuadro de diálogo Agregar nuevo elemento:

    Una captura de pantalla del cuadro de diálogo Agregar nuevo elemento, con los complementos de Unreal Engine seleccionados.

    Tiene opciones para agregar clases comunes de Unreal Engine, Módulo de Unreal Engine vacío y Complementos de Unreal Engine (que está seleccionado).

  3. Elija Complementos de Unreal Engine y, a continuación, elija Agregar para abrir el cuadro de diálogo Agregar complemento de Unreal Engine:

    Captura de pantalla del cuadro de diálogo Agregar nuevo complemento de Unreal Engine.

    Hay una lista de tipos de complemento (Avanzado está seleccionado) y campos para el nombre del complemento, la ruta de acceso, el autor, la descripción y la dirección URL. Hay una casilla de Es complemento en beta (desmarcada) y una casilla de Actualizar información de IntelliSense mediante herramientas del Editor de Unreal (marcada).

  4. Elija el tipo de complemento en la lista Tipo de complemento.
  5. Proporcione el Nombre del complemento, el Autor del complemento, la Descripción del complemento y la Dirección URL del complemento.
  6. Active la casilla Es complemento en beta según sea necesario.
  7. Active la casilla Actualizar información de IntelliSense mediante herramientas del Editor de Unreal para elegir si Visual Studio debe usar las herramientas del Editor de Unreal para actualizar la información de IntelliSense. Esto hace que la herramienta de compilación de Unreal vuelva a generar el archivo de solución de Visual Studio.
  8. Elija Agregar para generar los archivos de encabezado y origen del complemento para el nuevo complemento y agréguelos al archivo de solución de Visual Studio. Esto da como resultado un mensaje para volver a cargar el proyecto. Elija Recargar para volver a cargar el proyecto.

Visual Studio Tools para Unreal Engine
Visualización de planos técnicos de Unreal Engine en Visual Studio
Visualización de registros de Unreal Engine en Visual Studio
Visualización de macros de Unreal Engine en Visual Studio