Configuración de Android Single Instance Service

Esta guía explica cómo configurar Android Single Instance Service (ASIS) en Unreal Engine, y cómo crear, empaquetar y ejecutar tu proyecto en Unreal Engine como una aplicación de Android.

Configuración del SDK y NDK de Android

Para configurar ASIS, primero debes configurar el kit de desarrollo de software (SDK) de Android y el kit de desarrollo nativo (NDK) de Android en Unreal Engine. Unreal Engine usa Android Studio y las herramientas de línea de comandos del SDK de Android para la descarga e instalación de los componentes del SDK de Android necesarios para desarrollar proyectos de Android.

Para configurar el SDK y el NDK de Android, sigue estos pasos:

1. Sigue los pasos de la página Configuración del SDK y NDK de Android.  

2. Si usas Unreal Engine 5.5 o una versión superior, activa las siguientes plataformas y herramientas del SDK:

   1. SDK Tools > Android SDK Build-Tools 36 > 35.0.0 y 34.0.0

      

   2. SDK Tools > NDK (Side by side) > 25.1.8937393

      

   3. SDK Platforms > Android 14.0 ("UpsideDownCake"), API Level 34

      

Cómo crear un proyecto nuevo a partir de la plantilla ASIS  

Después de instalar el SDK y el NDK de Android, puedes configurar el complemento de plantilla ASIS. El complemento se envía como un archivo independiente, por lo que tendrás que seguir unos pasos manuales para preparar el código fuente de Unreal Engine.

Cómo obtener el código fuente de Unreal Engine

Descarga el código fuente más reciente de UE5 Main en Perforce o Github. Para obtener más información sobre el uso de Perforce y Github con Unreal Engine, consulta los siguientes recursos:

• Utilización de Perforce como control de versiones

• Cómo usar Unreal Engine 5 - Perforce

• Cómo acceder al código fuente de Unreal Engine en Github

• Descarga del código fuente de Unreal Engine

• Compilación de Unreal Engine desde el código fuente

Configuración del complemento ASIS

1. Ve a la carpeta Templates de ASIS.

1. Ve a la carpeta Templates de ASIS.

   1. Si usas Perforce, dirígete a UE5_Main\Engine\Restricted\NotForLicensees\Plugins\AndroidSingleInstanceService\Templates\.

   2. Si usas GitHub, accede al branch ue5-main y dirígete a ue5-main\Engine\Restricted\NotForLicensees\Plugins\AndroidSingleInstanceService. 

2. Copia la carpeta TP_HMI_ASIS en UE5_Main\Templates\ (Perforce) o ue5-main\Templates\ (GitHub).

3. Copia el siguiente código y pégalo en UE5_Main\Templates\TemplateCategories.ini (Perforce) o ue5-main\Templates\TemplateCategories.ini (GitHub):

   C++

   Categories=(Key="HMI", LocalizedDisplayNames=((Language="en",Text="Automotive\nHMI &\nVehicle Cockpit using Android Single Instance Service")), LocalizedDescriptions=((Language="en",Text="Find templates for automotive vehicle cockpit using Android Single Instance Service"), Icon="TP_HMI_ASIS/Media/AutomotiveHMI_2x.png", IsMajorCategory=true)

   Copy full snippet(1 line long)

4. Ejecuta UnrealEditor. El explorador de proyectos de UE debería incluir ahora una nueva plantilla HMI:

   

5. Haz clic en Crear. El proyecto debería verse como la siguiente captura de pantalla:

   

Cómo añadir el complemento ASIS a un proyecto existente

Cómo añadir el complemento ASIS a un proyecto existente

Si ya tienes un proyecto al que quieres añadir ASIS, sigue estos pasos:

1.  Ve a Editar > Complementosy activa AndroidSingleInstanceService.

   

2. Copia el siguiente código y pégalo en el archivo {Project_Name}/Config/DefaultGame.ini:

   Config

   [Staging]
   +RemapDirectories=(From="Engine/Restricted/NotForLicensees/Plugins/AndroidSingleInstanceService", To="Engine/Plugins/Runtime/AndroidSingleInstanceService")
   +RemapDirectories=(From="Engine/Restricted/NotForLicensees/Plugins/Experimental/MultiWindow", To="Engine/Plugins/Experimental/MultiWindow")

   Copy full snippet(3 lines long)

3. En Unreal Engine, ve a Editar > Configuración del proyecto.

4. En Complementos > AndroidSingleInstanceService, habilita los siguientes ajustes:

   

   1. Compilar ASISProject

   2. Habilitar generación de bibliotecas de asis

   3. Usar AndroidSingleInstanceService

Cómo empaquetar y ejecutar el proyecto ASIS

Después de configurar ASIS en tu proyecto de Unreal Engine, puedes empaquetar y ejecutar el proyecto como una aplicación de Android.

Para empaquetar el proyecto ASIS como una aplicación de Android, sigue estos pasos:

1. En la barra de herramientas principal, haz clic en Plataformas > Android > Empaquetar proyecto.

   

2. Comprueba el registro de salida para asegurarte de que la compilación se ha realizado correctamente.

   

El paquete se guarda por defecto en /Documents/UnrealProjects/_packages/ASIS_Package.

Comunicación entre la aplicación de Android y el APK de Unreal Engine

Después de empaquetar la aplicación, puedes usar una aplicación cliente de ejemplo para comunicarse con el APK de Unreal Engine.

El paquete de Unreal Engine se compone de tres partes principales:

• Un APK con Android Service. Se encuentra en la carpeta elegida durante el diálogo de empaquetado del proyecto.

• Un conjunto de bibliotecas auxiliares de ASIS que se usan en las aplicaciones cliente.

  C++

  Binaries/Android/aars
  ├── asisclientlib-1.0.1-debug.aar
  ├── asisclientlib-1.0.1-debug.jar
  ├── asiscommon-1.0.1-debug.aar
  └── asiscommon-1.0.1-debug.jar

  Copy full snippet(5 lines long)

• Una aplicación cliente de ejemplo que se comunica con el servicio. No se encuentra en el proyecto de Unreal Engine empaquetado, sino en la carpeta Binaries de tu proyecto de Unreal Engine (\Unreal Projects\{Project_Name}\Binaries\Android).

  

Puedes usar Android Studio para abrir el proyecto de Android de ejemplo. Pasará automáticamente por el proceso de compilación de Android cuando lo abras. 

También puedes compilar el proyecto desde la siguiente línea de comandos:

cd {Project_Name}\Binaries\Android\ExampleUseCase_{Project_Name}\
gradlew assembleDebug

Este comando generará un archivo APK en {Project_Name}\Binaries\Android\ExampleUseCase_{Project_Name}\app\build\outputs\apk\debug\app-debug.apk.

En Android Studio, con un dispositivo Android seleccionado, puedes ejecutar la aplicación pulsando Mayús + F10 o haciendo clic en el botón Reproducir de la barra de herramientas superior.

Para instalar el APK en tu dispositivo Android, ejecuta el siguiente comando adb:

adb install {Project_Name}.apk

En la aplicación de tu dispositivo, toca Activar vista1, Activar vista2 y Activar vista3 para ver cómo se comunica Android Service con la aplicación Unreal Engine.