Configuración avanzada del SDK de Android

Unreal Engine usa el kit de desarrollo de software (SDK) de Android que se distribuye con Android Studio para todos los componentes esenciales de desarrollo de Android, incluido el kit de desarrollo nativo (NDK) de Android. Esta página proporciona un tutorial para configurar Android Studio y garantizar que Unreal Engine reconozca estos componentes correctamente, así como algunos consejos para solucionar problemas relacionados con la gestión de instalaciones del NDK y compilaciones anteriores del motor.

Configuración recomendada

Asegúrate de que Unreal Editor y el iniciador de Epic Games estén cerrados para garantizar que no haya problemas con la instalación de los componentes del NDK ni con la configuración de las variables de entorno para el motor.

Si necesitas compatibilidad con una instalación anterior de Unreal Engine, consulta la sección sobre el direccionamiento manual de rutas del SDK. Puedes encontrar la versión del NDK necesario para tu versión de Unreal Engine en la página de requisitos de desarrollo de Android.

Instala Android Studio

Antes de configurar los componentes necesarios del SDK y el NDK en tu ordenador, debes instalar Android Studio.

1. Ve a Android Studio Archive en tu navegador web. Baja hasta Android Studio Flamingo | 2022.2.1 Patch 2 May 24, 2023. Amplía el desplegable y descarga el instalador adecuado o el archivo zip para tu sistema operativo.

   

2. Ejecuta el instalador de Android Studio. En el cuadro de diálogo de instalación de Android Studio, haz clic en Next para continuar.

3. En el cuadro de diálogo Choose Components, deja los componentes predeterminados activados. Haz clic en Next para continuar.

4. En el cuadro de diálogo Install Locations, asegúrate de que la posición de instalación sea la predeterminada. Haz clic en Next para continuar.

   Si eliges una posición de instalación personalizada, la secuencia de comandos SetupAndroid no podrá encontrar archivos a menos que la edites primero. Recomendamos encarecidamente mantener la ubicación de instalación predeterminada.

5. En el cuadro de diálogo Choose Start Menu Folder, haz clic en Install para comenzar el proceso de instalación.

6. Cuando termine la instalación, haz clic en Next para empezar a configurar los componentes.

7. Cuando finalice la instalación, asegúrate de que esté marcada la casilla Start Android Studio y haz clic en Finish para salir del instalador.

Configura Android Studio para el primer uso

Cuando inicies tu nueva instalación de Android Studio por primera vez, sigue estos pasos:

1. Cuando aparezca el cuadro de diálogo de Data Sharing, elige si quieres enviar estadísticas de uso a Google. Esta es una opción que puedes elegir a tu discreción. Al seleccionar cualquiera de las dos opciones, se pasará al siguiente paso.

2. En el cuadro de diálogo de bienvenida a Android Studio, haz clic en el menú desplegable More Actions y en SDK Manager.

   

3. En los ajustes del sistema del SDK de Android, haz clic en el botón Edit que hay junto a Android SDK Location.

   

4. En el cuadro de diálogo SDK Components Setup, los componentes necesarios ya están seleccionados. Haz clic en Next para instalarlos.

   

5. En la ventana Verificar Setings, haz clic en Next de nuevo para continuar con la instalación.

6. Cuando termine la instalación, clic en Finish.

7. En el menú Settings, haz clic en la pestaña SDK Tools. Esto muestra una lista de componentes opcionales.

8. Marca la casilla Show Package Details para mostrar todos los componentes disponibles del SDK.

9. Marca la casilla de Android SDK Command-line Tools (latest). Haz clic en Apply para descargar e instalar este componente.

   

10. Haz clic en OK para cerrar la ventana y el diálogo de bienvenida.

Finaliza la instalación de Android Studio en tu SO

Después de completar todos los pasos anteriores, debes finalizar la instalación para asegurarte de que tu entorno esté completamente configurado antes de continuar. Cada sistema operativo requiere un paso diferente para finalizar la instalación.

Restablece o verifica tus variables de entorno

Los pasos de esta sección están destinados principalmente a los usuarios que vayan a pasar de UE 5.2 y versiones anteriores a UE 5.3 y versiones posteriores, y que tal vez deban restablecer sus variables de entorno. Si vas a instalar UE y Android Studio desde cero, ve directamente a la siguiente sección.

Esto es especialmente importante para los usuarios que han usado AGDE para la depuración, ya que ahora tanto UE como AGDE se dirigen al directorio jbr y no necesitan variables de entorno separadas.

1. Abre las propiedades del sistema de tu ordenador.

2. Haz clic en el botón Variables de entorno.

3. Si tienes una variable de entorno llamada AGDE_JAVA_HOME, bórrala. Esta variable ya no es necesaria, puesto que ahora tanto Unreal Engine como AGDE usan la misma versión de Java.

4. Restablece o verifica las siguientes variables de entorno.

   Variable de entorno	Valor esperado
   JAVA_HOME	C:\Archivos de programa\Android\Android Studio\jbr
   ANDROID_HOME	C:\Usuarios(nombre de usuario)\AppData\Local\Android\Sdk
   NDK_ROOT	C:\Usuarios(nombre de usuario)\AppData\Local\Android\Sdk\ndk(número de versión del NDK)
   NDKROOT	C:\Usuarios(nombre de usuario)\AppData\Local\Android\Sdk\ndk(número de versión del NDK)

   Reemplaza (nombre de usuario) por tu nombre de usuario y (número de versión del NDK) por el nombre del directorio de la versión necesaria para tu instalación.

   Para una solución fácil, elimina tus variables de entorno. Las hemos reemplazado por la secuencia de comandos SetupAndroid en un paso posterior.

Si necesitas compatibilidad con una versión anterior de Unreal Engine, te recomendamos que sigas los pasos anteriores para mantener la compatibilidad con las versiones actuales y futuras de Unreal Engine. Para conservar las rutas de tus versiones anteriores de Unreal Engine, te recomendamos que edites tu configuración del proyecto y configures manualmente las rutas del SDK para sus versiones del SDK, NDK y JDK de Android. Consulta «Direccionamiento manual de rutas del SDK» a continuación para obtener más información.

Ejecuta la secuencia de comandos SetupAndroid

Una vez instalados los componentes necesarios del SDK de Android, puedes usar la secuencia de comandos SetupAndroid para descargar e instalar la versión adecuada del NDK de Android.

1. Abre el directorio Engine/Extras/Android y ejecuta la secuencia de comandos SetupAndroid adecuada para tu sistema operativo:

   • SetupAndroid.bat – Windows

   • SetupAndroid.command – Mac

   • SetupAndroid.sh – Linux.

2. La secuencia de comandos te pedirá que aceptes el acuerdo de licencia del SDK de Android. Escribe Y y pulsa Intro para aceptar.

3. Cuando termine la instalación, pulsa cualquier tecla para cerrar la línea de comandos.

4. Reinicia el ordenador para que todos los cambios surtan efecto.

El directorio de instalación del NDK debería ser C:/Usuarios/[nombre de usuario]/AppData/Local/Android/SDK/ndk/, donde [nombre de usuario] es el nombre de inicio de sesión de tu ordenador. Deberías ver una carpeta con la versión del NDK necesaria en esta ubicación.

Direccionamiento manual de rutas del SDK

Si has seguido las instrucciones anteriores sin problemas, Unreal Engine asociará automáticamente las rutas del SDK para el SDK de Android, la versión actual del NDK de Android y el kit de desarrollo de Java (JDK). Sin embargo, si usas una versión anterior de Unreal Engine junto con Android Studio, es posible que tengas que configurar manualmente las rutas de tus SDK para que sean compatibles. Lo más probable es que tengas que hacer esto si vas a migrar de UE 5.0, 5.1 o 5.2 a UE 5.3 o versiones posteriores.

Para encontrar las rutas de SDK, abre Editar > Configuración del proyecto y luego dirígete a la sección Plataformas > Android > SDK de Android.

Si estos campos están en blanco, UE recurre a un conjunto de rutas por defecto usadas en el proceso de instalación de las secciones anteriores. Si tienes varias instalaciones de estos componentes, o si los has instalado en directorios no estándar, puedes proporcionar manualmente sus rutas aquí. También puedes abrir BaseEngine.ini y proporcionarlos en la sección [/Script/AndroidPlatformEditor.AndroidSDKSettings].

[/Script/AndroidPlatformEditor.AndroidSDKSettings]
    SDKPath = (Path="C:\Filepath")
    NDKPath = (Path="C:\Filepath")
    JDKPath = (Path="C:\Filepath")

Si las entradas para SDKPath, NDKPath y JDKPath no existen en tu BaseEngine.ini, se usará la ruta por defecto al directorio de inicio de Android.