Inicio rápido: Visual Studio Tools para Unreal Engine

En este artículo, descargue un ejemplo de juego de Unreal Engine (UE) y configure Visual Studio Tools para Unreal Engine. Visual Studio Tools para Unreal Engine es una extensión gratuita que le ayuda a desarrollar juegos con Unreal Engine. Proporciona características que mejoran la experiencia de desarrollo de Unreal Engine en Visual Studio.

Prerrequisitos

Debe instalarse lo siguiente:

• Visual Studio versión 17.10 o posterior.
• Unreal Engine versión 5 o posterior porque el ejemplo usado en este artículo requiere Unreal Engine 5 o posterior.
• Visual Studio Tools para Unreal Engine. Consulte Instalar Visual Studio Tools para Unreal Engine para obtener instrucciones de instalación.

Descarga y compilación del ejemplo de juego de Lyra en Visual Studio

Lyra es un proyecto de juego de ejemplo para aprender sobre Unreal Engine. Consulte la secciónDescargar el juego de inicio Lyra en Muestra de Juego Lyra para obtener instrucciones de descarga. Si lo adquiriste a través de la instalación de código fuente de Unreal Engine, esa versión no contiene los recursos necesarios para compilar y ejecutar el juego. Use las instrucciones de descarga para obtener todo lo que necesita a través del instalador de Epic.

Configuración del ejemplo de juego de Lyra para usar Visual Studio Tools para Unreal Engine

A partir de la versión 17.7 de Visual Studio 2022, el complemento Visual Studio Tools para Unreal Engine se incluye con la instalación de Unreal Engine. Ya no es necesario ver planos técnicos de Unreal Engine. Si tiene una versión anterior de Visual Studio, consulte Instalación de Visual Studio Tools para Unreal Engine para instalar el complemento manualmente.

Después de descargar el ejemplo del juego, actualice LyraStarterGame.uproject para usar el complemento Visual Studio Tools. Una manera de hacerlo es en el Editor de Unreal. Cargue el proyecto de Lyra y, en el menú principal, elija Editar complementos>. Busque el complemento Visual Studio Integration Tools y active la casilla situada junto a él.

Otra manera de hacerlo es editar manualmente el archivo LyraStarterGame.uproject. Así es como:

1. Abra el archivo LyraStarterGame.uproject en un editor de texto. En el directorio donde ha instalado la muestra del juego.

2. Agregue lo siguiente al final de la sección Plugins:

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

En Unreal Engine

1. Abra el proyecto de Lyra en Unreal Engine.
2. En el menú principal del editor de Unreal Engine, elija Herramientas>Generar Proyecto de Visual Studio. Esto crea el archivo de solución para Visual Studio.
3. En el menú principal del editor de unreal Engine, elija Herramientas>Abrir Visual Studio para abrir el juego en Visual Studio. Si tiene varias versiones de Visual Studio en el equipo, asegúrese de que se abra la versión correcta: en el menú principal de Visual Studio, elija Ayuda>Acerca de Microsoft Visual Studio. Debe usar Visual Studio 2022, versión 17.7 o posterior. Si la versión correcta no se ha abierto, abra manualmente LyraStarterGame.sln en la versión correcta de Visual Studio.

en Visual Studio

1. Cambie la lista desplegable de Configuraciones de soluciones a el Editor de desarrollo . Esto habilita los Blueprints Visual Studio Tools para Unreal Engine:
2. Establezca que el proyecto de inicio sea el proyecto LyraStarterGame. En el Explorador de soluciones, haga clic con el botón derecho en la solución y seleccione Propiedades.
3. En el cuadro de diálogo Páginas de propiedades de la solución, en Propiedades comunes, seleccione Configurar proyectos de inicio.
4. Asegúrese de que Proyecto de inicio único está seleccionado y seleccione LyraStarterGame en la lista desplegable.

   

   En Propiedades comunes, se selecciona Configurar proyectos de inicio. Se selecciona el botón de radio del proyecto de inicio único. El proyecto de inicio en la lista desplegable es LyraStarterGame.

5. Elija Aceptar para cerrar el cuadro de diálogo.
6. En el menú principal de Visual Studio, elija Compilar>Compilar solución para compilar el juego.

Ventana de salida de compilación de Visual Studio

La ventana de salida de compilación de Visual Studio muestra el progreso de la compilación y los errores o advertencias que se producen. Puede abrir la ventana de salida de compilación desde el menú principal de Visual Studio a través de Ver>Salida.

A partir de Visual Studio 2022 17.12, puede hacer doble clic en una ruta de acceso absoluta a un archivo en la ventana de salida para abrir ese archivo en Visual Studio. El código fuente debe formar parte de la solución de Visual Studio y la ruta de acceso de la ventana de salida debe ser una ruta de acceso absoluta. Esto funciona al crear proyectos de Unreal Engine en Visual Studio u otros tipos de proyectos.

En la captura de pantalla siguiente se muestra la ventana de salida de una compilación del ejemplo LyraStarterGame. El usuario hace doble clic en una advertencia de LyraCharacter.generated.h. Dado que se proporciona la ruta de acceso absoluta a ese archivo, el archivo se abre en el editor.

Barra de herramientas de Unreal Engine

Visual Studio proporciona una barra de herramientas que mejora la experiencia de integración de desarrollo de Unreal Engine en Visual Studio. La barra de herramientas proporciona acceso rápido a tareas comunes de UE.

Active la barra de herramientas de Unreal Engine en Visual Studio desde el menú principal a través de View>Toolbars>Unreal Engine. La barra de herramientas tiene el siguiente aspecto:

Los botones de la barra de herramientas, de izquierda a derecha:

• El icono de reproducción es un botón de asociación rápido que se adjunta a los procesos enumerados en la lista desplegable a la derecha. En la lista desplegable se enumeran los procesos relacionados con Unreal Engine, lo que facilita la conexión al Editor de motor de Unreal más fácilmente. También puede usar esto para adjuntar a cualquier proceso.
• Botones para iniciar y detener el servidor de integración de Unreal Engine. El servidor de integración mejora el rendimiento de la integración de Unreal Engine con Visual Studio. Se ejecuta como un proceso en segundo plano y actualiza automáticamente la información de prueba a medida que trabaja en el proyecto. Puede desactivarlo para reclamar los recursos de la máquina e iniciarlo cuando desee las mejoras de integración. El servidor se inicia automáticamente al abrir un proyecto de UE en Visual Studio.
• Un botón para volver a examinar los recursos de Unreal Engine Blueprint. Esto actualiza la solución de Visual Studio con los recursos de Blueprint más recientes del proyecto Unreal Engine.
• Botón que abre la ventana de registro de Unreal Engine.
• Un botón para abrir la ventana de configuración de integración de Unreal Engine, donde puede actualizar y ver el estado general de la configuración y el estado de la herramienta de integración de Visual Studio, comprobar la compatibilidad con Blueprint, ver el estado del comprobador de convenciones de nomenclatura de Unreal Engine, entre otras cosas.

Lista desplegable de argumentos de la línea de comandos

Con frecuencia, puede iniciar el juego con diferentes combinaciones de argumentos de línea de comandos durante la parte de edición y depuración del bucle interno. Esto ahora es más fácil con la lista desplegable de argumentos de la línea de comandos:

La lista desplegable de argumentos de la línea de comandos se muestra después de la lista desplegable Plataformas de soluciones de la barra de herramientas Estándar. Hay una entrada para C:\UE\LyraStarterGame\LyraStarterGame.uproject -fullscreen y C:\UE\LyraStarterGame\LyraStarterGame.uproject -JsonDebugOutput.

Para agregar argumentos de línea de comandos, escríbalos en la lista desplegable y presione Entrar. Los argumentos se guardan en el orden en que se escriben y aparecen en la lista desplegable para su uso futuro.

Hay un límite de cinco líneas de comandos que puede agregar antes de que se quite el más antiguo para dejar espacio para uno nuevo.

El primer argumento al depurar un proyecto de Unreal Engine que se ejecuta en el editor de Unreal Engine debe ser la ruta de acceso al proyecto. Por ejemplo: C:\UE\LyraStarterGame\LyraStarterGame.uproject.

Para obtener más información sobre cómo utilizar la lista desplegable de argumentos de línea de comandos, consulte Pasar argumentos de línea de comandos durante la depuración (C++).

Pasos siguientes

Agregar clases, módulos y complementos de Unreal Engine en Visual Studio
Ver planos técnicos de unreal Engine en Visual Studio
Ver el registro de Unreal Engine en Visual Studio
Ver macros de Unreal Engine en Visual Studio