Como configurar o Serviço de Instância Única do Android

Este guia explica como configurar o Serviço de Instância Única (ASIS) do Android na Unreal Engine e, em seguida, como criar, empacotar e executar seu projeto da Unreal Engine como um aplicativo Android.

Configure o SDK e NDK do Android

Para configurar o ASIS, você deve primeiro configurar o Kit de desenvolvimento de software (SDK) e o Kit de desenvolvimento nativo (NDK) do Android na Unreal Engine. A Unreal Engine usa o Android Studio e as ferramentas de linha de comando do SDK do Android para baixar e instalar os componentes do SDK do Android necessários para desenvolver projetos Android.

Para configurar o SDK e o NDK do Android, siga estas etapas:

1. Siga as etapas na página Como configurar o SDK e o NDK para Android.  

2. Se você estiver usando a Unreal Engine 5.5 ou posterior, habilite as seguintes plataformas e ferramentas de SDK:

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

      

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

      

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

      

Crie um novo projeto a partir do modelo ASIS  

Após a instalação do SDK e do NDK do Android, você pode configurar o plugin de modelo ASIS. O plugin é entregue como um arquivo separado, portanto é necessário seguir etapas manuais para preparar o código-fonte da Unreal Engine.

Obtenha o código-fonte da Unreal Engine

Extraia o código-fonte mais recente do cabeçalho principal da UE5 no Perforce ou no GitHub. Para obter mais informações sobre como usar o Perforce e o GitHub com a Unreal Engine, consulte os seguintes recursos:

• Como usar o Perforce como controle do código-fonte

• Como usar a Unreal Engine 5 - Perforce

• Como acessar o código-fonte da Unreal Engine no GitHub

• Como baixar o código-fonte da Unreal Engine

• Como compilar a Unreal Engine a partir do código-fonte

Configure o plugin ASIS

1. Vá até a pasta "ASIS Templates".

1. Vá até a pasta "ASIS Templates".

   1. Se estiver usando o Perforce, vá até UE5_Main\Engine\Restricted\NotForLicensees\Plugins\AndroidSingleInstanceService\Templates\

   2. Se estiver usando o GitHub, acesse a ramificação UE5-main e vá até UE5-main\Engine\restrito\NotForLicensees\Plugins\AndroidSingleInstanceService. 

2. Copie a pasta TP_HMI_ASIS para UE5_Main\Templates\ (Perforce) ou ue5-main\Templates\ (GitHub).

3. Copie o código a seguir e cole em UE5_Main\Templates\TemplateCategories.ini (Perforce) ou 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. Execute o UnrealEditor. O Navegador de Projetos da Unreal agora deve incluir um novo modelo de IHM:

   

5. Clique em Criar. O projeto deve se parecer com a seguinte captura de tela:

   

Adicione o plugin ASIS a um projeto existente

Adicione o plugin ASIS a um projeto existente

Se você tiver um projeto existente ao qual deseja adicionar o ASIS, siga estas etapas:

1.  Vá até Editar > Plugins e habilite AndroidSingleInstanceService.

   

2. Copie o código a seguir e cole no arquivo {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. Na Unreal Engine, acesse Editar > Configurações de Projeto.

4. Em Plugins > AndroidSingleInstanceService, habilite as seguintes configurações:

   

   1. Compilar ASISProject

   2. Habilitar ASIS libs generation

   3. Usar AndroidSingleInstanceService

Empacote e executar o projeto ASIS

Após configurar o ASIS em seu projeto da Unreal Engine, você pode empacotar e executar o projeto como um aplicativo Android.

Para empacotar o projeto ASIS como um aplicativo Android, siga estas etapas:

1. Na barra de ferramentas principal, clique em Plataformas > Android > Empacotar projeto.

   

2. Verifique o Log de Saída para garantir que a compilação foi bem-sucedida.

   

Por padrão, o pacote é salvo em /Documents/UnrealProjects/_packages/ASIS_Package.

A comunicação entre o aplicativo Android e o APK da Unreal Engine.

Depois de empacotar o aplicativo, você pode usar um aplicativo cliente de exemplo para se comunicar com o APK da Unreal Engine.

O pacote da Unreal Engine inclui 3 partes principais:

• Um APK com Android Service. Ele está localizado na pasta escolhida na caixa de diálogo do pacote do projeto.

• Um conjunto de bibliotecas auxiliares ASIS usadas nos aplicativos 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)

• Um aplicativo cliente de exemplo que se comunica com o serviço. Ele não está localizado no projeto empacotado da Unreal Engine, mas na pasta "Binaries" do seu projeto da Unreal Engine (\Unreal Projects\{Project_Name}\Binaries\Android).

  

Você pode usar o Android Studio para abrir o projeto Android de exemplo. Ele passará automaticamente pelo processo de compilação para Android quando for aberto. 

Você também pode compilar o projeto usando o seguinte prompt de linha de comando:

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

Este comando gerará um arquivo APK em  {Project_Name}\Binaries\Android\ExampleUseCase_{Project_Name}\app\build\outputs\apk\debug\app-debug.apk.

No Android Studio, com um dispositivo Android selecionado, você pode executar o aplicativo pressionando Shift + F10 ou clicando no botão Play na barra de ferramentas superior.

Para instalar o APK no dispositivo Android, execute o seguinte comando adb:

adb install {Project_Name}.apk

No aplicativo em seu dispositivo, toque em Activate View1, Activate View2 e Activate View3 para visualizar o Android Service se comunicando com o aplicativo da Unreal Engine.