Erweiterte Android SDK-Einrichtung

Unreal Engine verwendet das Android Software Development Kit (SDK), das mit Android Studio für alle wichtigen Android Entwicklungskomponenten ausgeliefert wird, einschließlich des Android Native Development Kit (NDK). Diese Seite enthält eine Schritt-für-Schritt-Anleitung zum Einrichten von Android Studio und zum Sicherstellen, dass Unreal Engine diese Komponenten korrekt erkennt, sowie einige Tipps zur Fehlerbehebung für die Verwaltung von NDK-Installationen und früheren Engine-Builds.

Empfohlene Einrichtung

Stelle sicher, dass sowohl der Unreal Editor als auch der Epic Games Launcher geschlossen sind, um sicherzustellen, dass es keine Probleme mit der Installation von NDK-Komponenten oder dem Einstellen deiner Umgebungsvariablen für die Engine gibt.

Wenn du eine frühere Version von Unreal Engine unterstützen musst, lies den Abschnitt zum manuellen Festlegen von SDK-Pfaden. Die benötigte NDK-Version für deine Version von Unreal Engine findest du auf der Seite Voraussetzungen für die Android-Entwicklung.

Android Studio installieren

Bevor du die erforderlichen SDK- und NDK-Komponenten auf deinem Computer einrichtest, musst du Android Studio installieren.

1. Navigiere in deinem Webbrowser zu Android Studio Archive. Scrolle nach unten zu Android Studio Flamingo | 2022.2.1 Patch 2 May 24, 2023. Öffne das Dropdown-Menü und lade das für dein Betriebssystem geeignete Installationsprogramm oder die ZIP-Datei herunter.

   

2. Führe den Android Studio Installer aus. Klicke im Dialogfeld Android Studio Setup auf Next, um fortzufahren.

3. Lass im Dialogfeld Choose Components die Standardkomponenten aktiviert. Klicke auf Next, um fortzufahren.

4. Stelle sicher, dass im Dialogfeld Install Locations, dass der Installationsort auf den Standardwert eingestellt ist. Klicke auf Next, um fortzufahren.

   Wenn du einen benutzerdefinierten Installationsort wählst, wird das SetupAndroid-Script keine Dateien finden, es sei denn, du bearbeitest es zuerst. Wir empfehlen dringend, den Standardinstallationsort beizubehalten.

5. Klicke im Fenster Choose Start Menu Folder auf Install, um den Prozess zu beginnen.

6. Klicke nach Abschluss der Installation auf Next, um mit der Einrichtung der Komponenten zu beginnen.

7. Stelle nach Abschluss der Einrichtung sicher, dass das Kästchen Start Android Studio aktiviert ist und klicke dann auf Finish, um das Installationsprogramm zu verlassen.

Android Studio für die erstmalige Verwendung einrichten

Wenn du deine Neuinstallation von Android Studio zum ersten Mal startest, befolge diese Schritte:

1. Wenn das Dialogfeld Datenfreigabe angezeigt wird, wähle aus, ob du Nutzungsstatistiken an Google senden möchtest oder nicht. Dies ist eine Option, die du nach Belieben auswählen kannst. Die Auswahl einer der beiden Optionen führt dich zum nächsten Schritt.

2. Klicke im Dialogfeld Welcome to Android Studio auf das Dropdown-Menü More Actions und dann auf SDK Manager.

   

3. Klicke in den Android SDK-Systemeinstellungen auf die Schaltfläche Edit neben Android SDK Location.

   

4. Im Dialogfeld SDK Component Setup sind die benötigten Komponenten bereits ausgewählt. Klicke auf Next, um sie zu installieren.

   

5. Klicke im Fenster Verify Settings erneut auf Next, um die Installation fortzusetzen.

6. Klicke nach Abschluss der Installation auf Finish.

7. Klicke im Menü Settings auf den Tab SDK Tools. Dies zeigt eine Liste optionaler Komponenten an.

8. Aktiviere das Kontrollkästchen Show Package Details, um alle verfügbaren SDK-Komponenten anzuzeigen.

9. Aktiviere das Kontrollkästchen für Android SDK Command-line Tools (latest). Klicke auf Apply, um diese Komponente herunterzuladen und zu installieren.

   

10. Klicke auf OK, um das Fenster zu schließen und den Willkommensdialog zu beenden.

Abschliessen der Installation von Android Studio auf deinem Betriebssystem

Nachdem du alle oben genannten Schritte abgeschlossen hast, musst du deine Installation abschließen, um sicherzustellen, dass deine Umgebung vollständig eingerichtet ist, bevor du fortfahren kannst. Jedes System erfordert einen anderen Schritt zum Abschluss der Installation.

Umgebungsvariablen zurücksetzen oder überprüfen

Die Schritte in diesem Abschnitt sind hauptsächlich für Nutzer gedacht, die von UE 5.2 und älter auf UE 5.3 und neuer umsteigen, da sie möglicherweise ihre Umgebungsvariablen zurücksetzen müssen. Solltest du mit einer neuen Installation von UE und Android Studio arbeiten, fahre mit dem nächsten Abschnitt fort.

Dies ist besonders wichtig für Nutzer, die AGDE zum Debugging verwendet haben, da UE und AGDE nun beide auf das jbr-Verzeichnis zielen und keine separaten Umgebungsvariablen benötigen.

1. Öffne die System Properties deines Computers.

2. Klicke auf die Schaltfläche Environment Variables.

3. Wenn du eine Variable namens AGDE_JAVA_HOME hast, lösche diese. Diese Variable ist nicht mehr erforderlich, da sowohl Unreal Engine als auch AGDE jetzt dieselbe Java-Version verwenden.

4. Setze die folgenden Umgebungsvariablen zurück oder überprüfe sie.

   Umgebungsvariable	Erwarteter Wert
   JAVA_HOME	C:\Programm Files\Android\Android Studio\jbr
   ANDROID_HOME	C:\Users\(Nutzername)\AppData\Local\Android\SDK
   NDK_ROOT	C:\Users\(Nutzername)\AppData\Local\Android\SDK\ndk\(NDK Versionsnummer)
   NDKROOT	C:\Users\(Nutzername)\AppData\Local\Android\SDK\ndk\(NDK Versionsnummer)

   Ersetze (Nutzername) durch deinen Nutzernamen und (NDK-Versionsnummer) durch den Verzeichnisnamen für die Versionsnummer, die für deine Installation benötigt wird.

   Lösche zur einfachen Behebung deine Umgebungsvariablen. Sie werden in einem späteren Schritt durch das Script "SetupAndroid" ersetzt.

Sollten du eine frühere Version von Unreal Engine unterstützen müssen, empfehlen wir, den oben genannten Schritten zu folgen, um die Kompatibilität mit den aktuellen und zukünftigen Versionen von Unreal Engine zu gewährleisten. Um die Pfade für deine früheren Versionen von Unreal Engine zu erhalten, empfehlen wir dir, deine Projekt-Einstellungen zu bearbeiten und die SDK-Pfade für deren Versionen von Android SDK, NDK und JDK manuell als Ziel zu setzen. Weitere Informationen findest du unten unter „Manuelles Festlegen von SDK-Pfaden“.

SetupAndroid-Script ausführen

Wenn die benötigten Komponenten von Android SDK installiert sind, kannst du das Script SetupAndroid nutzen, um die passende Version des Android NDK herunterzuladen und zu installieren.

1. Öffne das Verzeichnis Engine/Extras/Android und führe das entsprechende SetupAndroid-Script für dein System aus:

   • SetupAndroid.bat – Windows

   • SetupAndroid.command – Mac

   • SetupAndroid.sh – Linux.

2. Du wirst aufgefordert, die Android SDK-Lizenzvereinbarung zu akzeptieren. Tippe Y ein und drücke Enter zum Akzeptieren.

3. Drücke nach Abschluss der Installation eine beliebige Taste, um die Eingabeaufforderung zu schließen.

4. Starte deinen Computer neu, damit alle Änderungen wirksam werden.

Das Installationsverzeichnis für NDK sollte C:/Users/[Nutzername]/AppData/Local/Android/SDK/ndk/ sein, wobei [Nutzername] dein Anmeldename für deinen Computer ist. Du solltest an diesem Speicherort einen Ordner sehen, der die benötigte NDK-Version enthält.

Manuelles Festlegen von SDK-Pfaden

Wenn du den obigen Anweisungen ohne Probleme gefolgt bist, wird Unreal Engine die SDK-Pfade für das Android SDK, die aktuelle Android NDK-Version und das Java Development Kit (JDK) automatisch zuordnen. Wenn du aber eine ältere Version der Unreal Engine zusammen mit Android Studio benutzt, musst du deine SDK-Pfade vielleicht manuell anpassen, damit sie kompatibel sind. Wahrscheinlich ist dies notwendig, wenn du von UE 5.0, 5.1 oder 5.2 auf UE 5.3 oder neuer migrierst.

Die SDK-Pfade findest du im Abschnitt Edit > Project Settings. Navigiere dort zu Platforms > Android > Android SDK.

Wenn diese Felder leer sind, greift UE auf eine Reihe von Standardpfaden zurück, die vom Installationsprozess in den vorherigen Abschnitten verwendet werden. Wenn du mehrere Installationen dieser Komponenten hast oder diese in Nicht-Standard-Verzeichnissen installiert hast, kannst du deren Pfade hier manuell angeben. Alternativ kannst du BaseEngine.ini öffnen und diese im Abschnitt [/Script/AndroidPlatformEditor.AndroidSDKSettings] angeben.

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

Wenn die Einträge für SDKPath, NDKPath und JDKPath nicht in deiner BaseEngine.ini-Datei existieren, wird der Standardpfad zum Android-Home-Verzeichnis verwendet.