Configuración del SDK y NDK de Android

Unreal Engine (UE) usa Android Studio y las herramientas de línea de comandos del SDK de Android para descargar e instalar los componentes del SDK de Android necesarios para desarrollar proyectos de Android.

Resumen de la instalación

Para instalar el SDK de Android, sigue estos pasos:

1. Ejecuta Turnkey para descargar e instalar automáticamente la versión necesaria de Android Studio.

2. Configura la instalación de Android Studio para que descargue las herramientas de línea de comandos del SDK de Android.

3. Cierra Android Studio y deja que Turnkey siga instalando los componentes necesarios del SDK de Android.

4. Reinicia el ordenador.

Estos pasos se explican con más detalle en las siguientes secciones.

Versiones necesarias

A continuación se indican los componentes de software necesarios para desarrollar proyectos de Android en Unreal Engine:

• Versión actual de UE: 5.6

• Versión de Android Studio: Koala 2024.1.2 29 de agosto de 2024

• SDK de Android:

  • Recomendado: SDK 34

  • Mínimo para la compilación: SDK 34

  • SDK objetivo por defecto para la distribución en dispositivos: 34

  • Nivel mínimo de instalación del SDK: 26

    Las distintas tiendas tienen sus propios requisitos mínimos para el SDK objetivo, que pueden diferir de los mencionados anteriormente.

• Versión del NDK: r27c

• Build-tools: 34.0.0

• Tiempo de ejecución de Java: OpenJDK 21.0.3 2024-04-16

• Se necesita AGDE v23.2.91+ para la depuración de AGDE. 

Configuración requerida

Para usar esta guía de instalación, debes tener instalado Unreal Engine 5.4 o una versión posterior. El proceso de instalación de Android Turnkey no está disponible en UE 5.3 o versiones anteriores. Para obtener instrucciones de instalación sobre esas versiones, consulta la Guía de configuración avanzada de Android Studio.

Cómo ejecutar Turnkey para comenzar a instalar Android Studio

UE usa una secuencia de comandos de Unreal Automation Tool llamada Turnkey para distribuir los SDK entre los equipos. Normalmente, Turnkey requiere que coloques los archivos de instalación del SDK de una plataforma en una ubicación común para tu equipo. Sin embargo, Android Studio está disponible públicamente, por lo que Turnkey puede descargarlo de forma automática y comenzar la configuración sin pasos adicionales.

Cómo ejecutar Turnkey desde Unreal Editor

Para ejecutar el proceso de instalación de Android Turnkey desde Unreal Editor, sigue estos pasos:

1. Abr Unreal Editor.

2. Haz clic en Plataformas > Android > Instalar SDK.

Cómo ejecutar Turnkey desde una línea de comandos

Para ejecutar el proceso de instalación de Android Turnkey desde una línea de comandos, sigue estos pasos:

1. Abre la línea de comandos.

2. Ve al directorio de instalación de Unreal Engine y ejecuta el siguiente comando:

   Línea de comandos

   C++

   RunUAT.bat Turnkey -Command=InstallSDK Platform=Android

   Copy full snippet(1 line long)

Configuración de Android Studio y las herramientas de línea de comandos de Android

Independientemente del método que utilices para ejecutar Turnkey, se descarga Android Studio y se inicia automáticamente la instalación. Sin embargo, antes de que puedas continuar, debes pasar por el asistente de instalación y descargar las herramientas de línea de comandos de SDK de Android para que Turnkey pueda obtener los otros componentes que UE necesita. Para completar la instalación, sigue estos pasos:

1. Cuando se te pida que selecciones componentes, deja los componentes por defecto activados.

2. Cuando se te pida que elijas el directorio de instalación, usa el directorio por defecto.

   Si no usas el directorio de instalación por defecto, Turnkey no podrá encontrar los archivos necesarios en un paso posterior. Recomendamos encarecidamente mantener el directorio por defecto. Para apuntar a un directorio independiente, consulta la Guía de configuración avanzada de Android Studio.

3. Cuando finalice la instalación, abre Android Studio.

4. En el cuadro de diálogo de bienvenida a Android Studio, haz clic en Más acciones y en SDK Manager.

   

Esto abrirá el menú de ajustes de Android Studio en Apariencia y comportamiento > Ajustes del sistema > SDK de Android.

1. Haz clic en la pestaña Herramientas del SDK.

2. Selecciona Herramientas de la línea de comandos del SDK de Android (más recientes) y haz clic en Aplicar. Esto descarga las herramientas de línea de comandos, que son necesarias para configurar automáticamente Android Studio para UE.

   

3. Haz clic en Aceptar para cerrar la ventana de ajustes; luego cierra el cuadro de diálogo de bienvenida a Android Studio.

4. Cierra Android Studio y regresa a Unreal Editor o a la línea de comandos.

Finalización y verificación de la configuración del SDK

Después de cerrar Android Studio, Turnkey reanuda la descarga e instalación de otros componentes del SDK de Android. Una vez completado el proceso, aparecerá un mensaje para informarte de si se ha realizado correctamente.

Para finalizar la instalación del SDK de Android y asegurarte de que funciona correctamente, sigue estos pasos:

1. Cierra Unreal Editor o la línea de comandos.

2. Para finalizar tus variables de entorno de Android, cierra sesión en tu dispositivo y vuelve a iniciarla.

3. Abre Unreal Editor y clic en Plataformas > Android. La versión permitida y la versión instalada del SDK deben coincidir y no debería aparecer ningún botón para instalar o reparar el SDK de Android.

   

Resolución de problemas

Si has realizado la instalación desde un sistema nuevo, los pasos anteriores deberían dar como resultado una configuración del SDK que funcione. Sin embargo, pueden surgir conflictos a causa de instalaciones y variables de entorno antiguas. Para obtener información sobre cómo diagnosticar y solucionar problemas específicos que impidan configurar el SDK de Android, consulta la Guía de configuración avanzada de Android Studio.