Einrichtung des Android Single Instance Service

Diese Anleitung erläutert, wie Sie Android Single Instance Service (ASIS) in Unreal Engine einrichten und wie Sie Ihr Unreal Engine-Projekt erstellen, paketieren und als Android-Anwendung ausführen.

Einrichten von Android-SDK und -NDK

Um ASIS einzurichten, müssen Sie zuerst das Android Software Development Kit (SDK) und das Android Native Development Kit (NDK) in Unreal Engine einrichten. Unreal Engine verwendet Android Studio sowie die Android-SDK-Befehlszeilenwerkzeuge, um die für die Entwicklung von Android-Projekten erforderlichen Android-SDK-Komponenten herunterzuladen und zu installieren.

Befolgen Sie diese Schritte, um Android SDK und -NDK einrichten:

1. Folgen Sie den Schritten auf der Seite Setting Up Android SDK and NDK (Einrichtung von Android SDK und NDK).  

2. Wenn Sie Unreal Engine 5.5 oder höher verwenden, müssen Sie folgende SDK-Plattformen und -Werkzeuge aktivieren:

   1. SDK-Werkzeuge > Android SDK Build-Tools 36 > 35.0.0 und 34.0.0

      

   2. SDK-Werkzeuge > NDK (nebeneinander) > 25.1.8937393

      

   3. SDK-Plattformen > Android 14.0 („UpsideDownCake“), API-Stufe 34

      

Erstellen eines neuen Projekts aus der ASIS-Vorlage  

Nachdem Android SDK und NDK installiert sind, können Sie das ASIS-Vorlagen-Plugin einrichten. Das Plugin wird als separates Archiv ausgeliefert. Daher müssen manuelle Schritte zur Vorbereitung des Unreal Engine-Quellcodes durchgeführt werden.

Abrufen des Unreal Engine-Quellcodes

Laden Sie den aktuellen Quellcode über das UE5-Hauptmenü entweder in Perforce oder Github herunter. Weitere Informationen zur Verwendung von Perforce und Github mit Unreal Engine finden Sie in den folgenden Ressourcen:

• Using Perforce as Source Control (Verwenden von Perforce als Quellkontrolle)

• How To Use Unreal Engine 5 - Perforce (So verwenden Sie Unreal Engine 5 – Perforce)

• Accessing Unreal Engine source code on Github (Zugriff auf Unreal Engine-Quellcode über GitHub)

• Herunterladen des Unreal-Engine-Quellcodes

• Erstellen von Unreal Engine über den Quellcode

Einrichten des ASIS-Plugins

1. Navigieren Sie zum ASIS-Vorlagen-Ordner.

1. Navigieren Sie zum ASIS-Vorlagen-Ordner.

   1. Wenn Sie Perforce verwenden, navigieren Sie zu UE5_Main\Engine\Restricted\NotForLicensees\Plugins\AndroidSingleInstanceService\Templates\.

   2. Wenn Sie GitHub verwenden, navigieren Sie zur Verzweigung ue5-main und dann zu ue5-main\Engine\Restricted\NotForLicensees\Plugins\AndroidSingleInstanceService. 

2. Kopieren Sie den Ordner TP_HMI_ASIS nach UE5_Main\Templates\ (Perforce) bzw. ue5-main\Templates\ (GitHub).

3. Kopieren Sie den folgenden Code und fügen Sie ihn in UE5_Main\Templates\TemplateCategories.ini (Perforce) bzw. ue5-main\Templates\TemplateCategories.ini (GitHub) ein:

   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. Führen Sie UnrealEditor aus. Der Unreal-Projektbrowser sollte nun eine neue HMI-Vorlage enthalten:

   

5. Klicken Sie auf Erstellen. Das Projekt sollte wie der folgende Screenshot aussehen:

   

Hinzufügen des ASIS-Plugins zu einem bestehenden Projekt

Hinzufügen des ASIS-Plugins zu einem bestehenden Projekt

Wenn Sie ein bestehendes Projekt haben, dem Sie ASIS hinzufügen möchten, befolgen Sie diese Schritte:

1.  Navigieren Sie zu Bearbeiten > Plugins und aktivieren Sie AndroidSingleInstanceService.

   

2. Kopieren Sie den folgenden Code und fügen Sie ihn in die Datei {Project_Name}/Config/DefaultGame.ini ein:

   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. Navigieren Sie in Unreal Engine zu Bearbeiten > Projekt-Einstellungen.

4. Aktivieren Sie unter Plugins > AndroidSingleInstanceService die folgenden Einstellungen:

   

   1. Compile ASISProject

   2. Enable asis libs generation

   3. Use AndroidSingleInstanceService

Paketieren und Ausführen des ASIS-Projekts

Nachdem Sie ASIS in Ihrem Unreal Engine-Projekt eingerichtet haben, können Sie das Projekt paketieren und als Android-Anwendung ausführen.

Befolgen Sie diese Schritte, um das ASIS-Projekt als Android-Anwendung zu paketieren:

1. Klicken Sie in der Haupt-Symbolleiste auf Plattformen > Android > Projekt paketieren.

   

2. Überprüfen Sie das Output-Log, um sicherzustellen, dass der Build erfolgreich war.

   

Das Paket wird standardmäßig unter /Documents/UnrealProjects/_packages/ASIS_Package gespeichert.

Kommunikation zwischen der Android-Anwendung und dem Unreal Engine APK

Nach der Paketierung der Anwendung können Sie eine Client-Beispielanwendung nutzen, um mit dem Unreal Engine APK zu kommunizieren.

Das Unreal Engine-Paket enthält 3 Hauptteile:

• Ein APK mit Android Service. Es befindet sich in dem Ordner, der im Paket-Dialogfeld ausgewählt wurde.

• Ein Satz mit ASIS-Hilfsbibliotheken, die in den Client-Anwendungen verwendet werden.

  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)

• Eine Client-Beispielanwendung, die mit dem Service kommuniziert. Diese befindet sich nicht im paketierten Unreal Engine-Projekt, sondern im Binärdateien-Ordner Ihres Unreal Engine-Projekts (\Unreal Projects\{Project_Name}\Binaries\Android).

  

Sie können Android Studio verwenden, um das Android-Beispielprojekt zu öffnen. Es durchläuft automatisch den Android-Build-Prozess, wenn Sie es öffnen. 

Sie können das Projekt auch mithilfe der folgenden Befehlszeilenaufforderung erstellen:

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

Dieser Befehl erstellt eine APK-Datei unter {Project_Name}\Binaries\Android\ExampleUseCase_{Project_Name}\app\build\outputs\apk\debug\app-debug.apk.

In Android Studio können Sie die Anwendung auf einem ausgewählten Android-Gerät durch Drücken von Umschalttaste + F10 oder durch Klicken auf die Schaltfläche Spielen in der oberen Werkzeugleiste ausführen.

Um das APK auf Ihrem Android-Gerät zu installieren, führen Sie den folgenden adb-Befehl aus:

adb install {Project_Name}.apk

Klicken Sie in der Anwendung auf Ihrem Gerät auf Activate View1, Activate View2 und Activate View3, um zu sehen, wie der Android-Dienst mit der Unreal Engine-Anwendung kommuniziert.