Inicio rápido de desarrollo de Linux

Unreal Engine (UE) es compatible con el desarrollo en dispositivos Linux mediante compilaciones creadas a partir del código fuente o compilaciones precompiladas e instaladas. Esta página contiene instrucciones sobre cómo configurar Unreal Engine en Linux, incluido el entorno de desarrollo y el proceso de compilación. Cuando termines este tutorial, sabrás cómo desarrollar aplicaciones en Unreal Engine usando tu máquina Linux.

1. Software y hardware recomendados

Unreal Engine es compatible con una gran variedad de distribuciones de Linux e IDE, siempre que cumplan estos requisitos mínimos:

Para que Unreal Editor funcione correctamente, te recomendamos que tu sistema cumpla los siguiente:

Para configurar tu entorno de desarrollo, te recomendamos el siguiente software, con el que hacemos pruebas con más frecuencia:

Consulta la documentación de tu distribución de Linux o IDE para obtener más información sobre cómo establecerlos. Aunque la configuración de tu sistema operativo y hardware queda fuera del alcance de esta documentación, a continuación se explica cómo configurar tu IDE para que funcione con Unreal Engine.

2. Instalación de Unreal Engine

Puedes configurar Unreal Engine en Linux instalando una versión precompilada o compilando el motor desde el código fuente.

2a. Descarga una compilación instalada

La opción más sencilla para ejecutar Unreal Engine es usar una compilación instalada. Para descargar e instalar una, sigue estos pasos:

Unreal Engine en Linux es compatible con las compilaciones instaladas precompiladas, además de compilaciones de código fuente. Para obtener más información sobre el uso de compilaciones de código fuente, consulta Building Unreal Engine from Source (Cómo compilar Unreal Engine a partir del código fuente).

Para usar una compilación precompilada, sigue estos pasos:

1. Abre la página Unreal Engine para Linux. Se te pedirá que crees una cuenta de Epic Games o inicies sesión en ella. Si ya tienes una, elige iniciar sesión. Si no tienes una cuenta, haz clic en Registrarse para crear una.

   

   Puedes registrar una cuenta de Epic Games con tu correo electrónico o una de tus cuentas de redes sociales o plataformas de juego admitidas.

   

2. Descarga el archivo .zip que contiene la versión de Unreal Engine que necesitas.

   

3. Descomprime el contenido del archivo .zip en el directorio de instalación que desees.

4. Ejecuta Engine/Binaries/Linux/UnrealEditor desde el terminal para iniciar Unreal Engine.

2b. Compila Unreal Engine desde el código fuente

Para instalar Unreal Engine desde el código fuente, consulta Cómo descargar el código fuente de Unreal Engine. Una vez que hayas compilado el motor, ejecuta Engine/Binaries/Linux/UnrealEditor desde Terminal para iniciar Unreal Editor.

3. Cómo configurar un nuevo proyecto

Para saber cómo configurar un nuevo proyecto, consulta las instrucciones de Cómo crear un nuevo proyecto en Unreal Engine. No necesitas una plantilla o tipo de proyecto específico para este tutorial, pero deberías asegurarte de que tiene C++ activado si estás configurando tu entorno para C++.

4. Configuración del entorno de desarrollo (C++)

Si vas a desarrollar proyectos en C++, tendrás que configurar la cadena de herramientas *clang* y un IDE para que funcionen con Unreal Engine. Aunque no necesitamos un IDE específico, recomendamos usar Visual Studio Code o Rider. Esta sección proporciona instrucciones específicas para Visual Studio Code, ya que también proporciona un entorno de desarrollo común para otros sistemas operativos.

1. Instala la cadena de herramientas Clang personalizada para tu configuración. Consulta Requisitos de desarrollo de Linux para obtener más información.

2. Localiza el directorio de instalación de Unreal Engine y abre Build/BatchFiles/Linux. A continuación, ejecuta SetupToolchain.sh.

3. Descarga e instala contra Code, así como el paquete de extensión oficial para C/ C++ y la extensión para C#. Son necesarios para leer el código fuente tanto de Unreal Engine como de sus herramientas de compilación.

4. Abre Unreal Editor, abre tus Preferencias del editor y establece tu editor de código fuente como Visual Studio Code, o modifica BaseEngine.ini para incluir lo siguiente:

   C++

   [/Script/SourceCodeAccess.SourceCodeAccessSettings]
            PreferredAccessor=VisualStudioCode

   Copy full snippet(2 lines long)

5. Ejecuta GenerateProjectFiles.sh -vscode para generar el espacio de trabajo de VS Code para la distribución de tu motor (en el caso de una compilación de código fuente) o tu proyecto. Añade -project=(ruta de tu proyecto) para elegir un proyecto específico.

Para obtener información sobre cómo configurar VS Code con IntelliSense y otras utilidades prácticas, consulta Configuración de VS Code para Unreal Engine.

5. Cómo compilar un proyecto

Ahora que tu entorno está completamente configurado, deberías ejecutar una compilación de prueba de tu proyecto para garantizar de que el proceso de trabajo funciona a la perfección.

5a. Crea un proyecto en Unreal Editor

Abre tu proyecto en Unreal Editor, haz clic en el desplegable Plataformas y haz clic en Linux > Empaquetar proyecto. Si tu sistema está configurado correctamente, Unreal Engine compilará tu proyecto, hará cook y lo empaquetará.

5b. Compila un proyecto a través de la línea de comandos

Para compilar un proyecto a través de la línea de comandos, usa el comando BuildCookRun de la secuencia de comandos RunUAT explicado en la guía Operaciones de compilación. El siguiente es un ejemplo de un comando BuildCookRun que funciona:

[UE Root Directory]/RunUAT BuildCookRun -Build -Cook -Stage -Package -Run -Project=[ProjectName]

También puedes usar la línea de comandos de Turnkey para iniciar el mismo proceso.

[UE Root Directory]/RunUAT Turnkey -command=ExecuteBuild -platform=Linux -Project=[ProjectName]