Einrichten von Android-SDK und -NDK

Unreal Engine (UE) 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.

Installationsübersicht

Führen Sie folgende Schritte aus, um Android SDK zu installieren:

1. Führen Sie Turnkey aus, um die benötigte Version von Android Studio automatisch herunterzuladen und zu installieren.

2. Konfigurieren Sie die Installation von Android Studio zum Herunterladen der Android SDK-Werkzeuge.

3. Schließen Sie Android Studio und lassen Sie Turnkey mit der Installation der benötigten Android SDK-Komponenten fortfahren.

4. Starten Sie Ihren Computer neu.

Die Schritte werden in den folgenden Abschnitten detailliert erläutert.

Erforderliche Versionen

Im Folgenden finden Sie alle erforderlichen Software Komponenten, die Sie zur Entwicklung von Android -Projekten in der Unreal Engine benötigen:

• Aktuelle UE-Version: 5.6

• Android Studio Version: Koala 2024.1.2 29. August 2024

• Android SDK:

  • Empfohlen: SDK 34

  • Minimum für Kompilierung: SDK 34

  • Standard-SDK für die Auslieferung auf Geräten: 34

  • Minimale SDK-Stufe: 26

    Die verschiedenen Stores haben ihre eigenen SDK-Mindestanforderungen, die von den oben genannten abweichen können.

• NDK-Version: r27c

• Build-Werkzeuge: 34.0.0

• Java Runtime: OpenJDK 21.0.3 2024-04-16

• AGDE v23.2.91+ für AGDE-Debugging erforderlich. 

Erforderliche Einrichtung

Um diese Installationsanleitung nutzen zu können, müssen Sie eine Installation von Unreal Engine 5.4 oder neuer haben. Der verarbeiten von Android Turnkey ist in UE 5.3 oder älter nicht verfügbar. Installationsanweisungen für diese Versionen finden Sie in der fortgeschrittenen Einrichtungsanleitung für Advanced Android Studio.

Turnkey ausführen, um die Installation von Android Studio zu beginnen

UE verwendet ein Unreal-Automatisierungswerkzeug-Script namens Turnkey, um SDKs an Teams zu verteilen. Normalerweise erfordert Turnkey, dass Sie die SDK-Installationsdateien einer Plattform an einem gewöhnlichen Speicherort für Ihr Team ablegen. Android Studio ist jedoch öffentlich verfügbar, weshalb Turnkey es automatisch herunterladen und mit der Einrichtung beginnen kann, ohne zusätzliche Schritte.

Turnkey vom Unreal Editor aus ausführen

Befolgen Sie diese Schritte, um den Installationsprozess von Android Turnkey im Unreal Editor auszuführen:

1. Öffnen Sie den Unreal Editor.

2. Klicken Sie auf Plattformen > Android > SDK installieren.

Turnkey über eine Befehlszeile ausführen

Befolgen Sie diese Schritte, um den Installationsprozess von Android Turnkey über die Befehlszeile auszuführen:

1. Öffnen Sie Ihre Kommandozeile.

2. Navigieren Sie zu Ihrem Unreal Engine Verzeichnis und führen Sie folgenden Befehl aus:

   Befehlszeile

   C++

   RunUAT.bat Turnkey -Command=InstallSDK Platform=Android

   Copy full snippet(1 line long)

Einrichten von Android Studio und Android Befehlszeilen-Werkzeuge

Unabhängig davon, welche Methode Sie verwenden, um Turnkey auszuführen, lädt es Android Studio herunter und startet die Installation automatisch. Bevor er jedoch fortfahren kann, müssen Sie selbst den Installationsassistenten durchlaufen und die Android SDK Werkzeuge herunterladen, damit Turnkey die anderen Komponenten holen kann, die UE benötigt. Befolgen Sie diese Schritte, um die Installation abzuschließen:

1. Wenn Sie dazu aufgefordert werden, Komponenten zu wählen, lassen Sie die Standard-Komponenten aktiviert.

2. Wenn Sie dazu aufgefordert werden, ein Verzeichnis zu wählen, verwenden Sie das Verzeichnis.

   Wenn Sie nicht das Standard- Verzeichnis verwenden, wird Turnkey nicht in der Lage sein, Dateien zu finden, die in einem späteren Schritt benötigt werden. Wir empfehlen dringend, das Standardverzeichnis beizubehalten. Informationen zum Ziel eines separaten Verzeichnisses finden Sie in der advanced Android Studio setup guide.

3. Öffnen Sie nach Abschluss der Installation Android Studio.

4. Klicken Sie im Dialog Willkommen bei Android Studio auf Weitere Aktionen und klicken Sie auf SDK-Manager.

   

Damit öffnen Sie das Android Studio Settings-Menü unter Aussehen und Verhalten > Systemeinstellungen > Android SDK.

1. Klicken Sie auf den Tab SDK-Tools.

2. Markieren Sie Android SDK Command-Line Werkzeuge (neuste) und klicken Sie dann auf Anwenden. Damit laden Sie die Befehlszeilen-Werkzeuge herunter, die zur automatischen Konfiguration von Android Studio für die UE benötigt werden.

   

3. Klicken Sie auf OK, um das Einstellungsfenster zu schließen, und schließen Sie anschließend das Dialogfeld Willkommen bei Android Studio.

4. Schließen Sie Android Studio und kehren Sie entweder zum Unreal Editor oder zu Ihrer Befehlszeile zurück.

Finalisieren und überprüfe Sie Ihre SDK-Einrichtung

Nachdem Sie Android Studio geschlossen haben, fährt Turnkey fort, andere Android SDK Komponenten herunterzuladen und zu installieren. Nach abschließen des Verfahrens erscheint eine Meldung, die mitteilt, ob der Vorgang erfolgreich war.

Befolgen Sie diese Schritte, um die Installation des Android SDK abzuschließen und sicherzustellen, dass sie korrekt funktioniert:

1. Schließen Sie den Unreal Editor oder die Befehlszeile.

2. Zum Finalisieren Ihrer Android Umgebungsvariablen melden Sie sich von Ihrem Gerät ab und melden sich dann wieder an.

3. Öffnen Sie den Unreal Editor und klicken Sie auf Plattformen > Android. Die erlaubte Version und die installierte Version des SDK sollten übereinstimmen, und Sie sollten keine Schaltfläche zum Installieren oder Reparieren des Android SDK sehen.

   

Fehlersuche

Wenn Sie von einem neuen System installiert haben, sollten die obigen Schritte zu einer funktionierenden SDK-Einrichtung führen. Allerdings können durch alte Umgebungsvariablen und Installationen Konflikte entstehen. Informationen zur Diagnose und Behebung spezifischer Probleme, die sich von der Einstellung des Android SDK abhalten, finden Sie unter advanced Android Studio setup guide.