Unreal Engine 5.8 with a current Android Studio. Updated November 2026. Written by the Algosyntax team.
Quick answer: Unreal builds Android and Meta Quest apps with Google’s Android tools, which you install yourself. In order:
- Add Android as a target platform for your engine in the Epic Games Launcher.
- Install Android Studio and tick Android SDK Command-line Tools.
- Close Unreal and run the engine’s
SetupAndroid.bat. - Install JDK 21 and point Unreal at it. The Java that ships with recent Android Studio (Java 25) is too new for UE 5.8’s Gradle and fails with
Unsupported class file major version 69. - Restart the editor, set your Android project settings, and package.
We wrote this while packaging VR Musician, our Quest 3 piano app. Every error below is one we hit.
Step 1: Add Android to your engine
In the Epic Games Launcher, open Library, click the small arrow next to your UE 5.8 install and choose Options. Under Target Platforms, tick Android and click Apply.
Without it the engine has no Engine/Build/Android folder and the Android SDK check fails. You can see that check in your project’s Saved/Logs/AutoSDKInfo.txt.
Step 2: Install Android Studio and the command-line tools
- Install Android Studio and open it once so it downloads the Android SDK.
- Go to Settings > Languages & Frameworks > Android SDK > SDK Tools.
- Tick Android SDK Command-line Tools (latest) and click Apply.
You only need Android Studio for these tools. Its emulator can’t run an immersive VR app, so you won’t test in it.
Step 3: Run SetupAndroid.bat
Close Unreal Engine, then run this file from your engine folder (double-click it, or run it from a terminal):
C:\Program Files\Epic Games\UE_5.8\Engine\Extras\Android\SetupAndroid.bat
Type y to accept the licences. For UE 5.8 it installed Android platform 36, build-tools 36.1.0, CMake 3.22.1 and NDK r27c (27.2.12479018), and set the ANDROID_HOME, NDKROOT and JAVA_HOME user variables.
“Unable to locate sdkmanager.bat” means step 2 was skipped: the command-line tools aren’t installed.
Step 4: Fix the Java version (the error that cost us the most time)
The first Android build failed in the Gradle step with:
Unsupported class file major version 69
Why: class file version 69 means Java 25. Recent Android Studio releases bundle Java 25 in their jbr folder, and SetupAndroid.bat pointed JAVA_HOME there. UE 5.8 builds with Gradle 8.13, which can’t run on Java 25.
Fix: install JDK 21 and point Unreal at it.
winget install Microsoft.OpenJDK.21
Then in the editor open Project Settings > Platforms > Android SDK and set Location of JAVA to the new folder, for example C:\Program Files\Microsoft\jdk-21.0.13.21-hotspot (the version number in your folder may differ). Setting your user JAVA_HOME to that folder also works.
If the cook already finished, package again with -skipcook from the command line so you don’t wait for a second full cook.
Step 5: Restart everything that reads environment variables
We got “NDK not found” although NDK r27c was installed. The editor, the launcher and the terminal had all started before SetupAndroid.bat set the variables, so they still had the old ones. Close and reopen them, or sign out of Windows and back in.
Step 6: Project settings for Meta Quest
In Project Settings > Platforms > Android:
| Setting | Value |
|---|---|
| Minimum SDK Version | 32 |
| Target SDK Version | 34 (Meta’s store requirement when we submitted) |
| Support arm64 | On. Turn x86_64 off. |
| Support Vulkan | On |
| Package for Meta Quest devices | On |
If the editor shows “Project is not configured for the Android platform”, click Configure Now. It copies the Android template files into your project’s Build/Android folder and doesn’t touch your signing settings.
Step 7: Be patient with the first cook
Our first Android cook took about 30 minutes, because every shader compiles for Android Vulkan. Some mobile shaders took 40 to 70 seconds each, so the package counter seemed frozen. It wasn’t. If you’re unsure, check that the log file’s last-modified time is still changing. Later cooks reuse the compiled shaders and are much faster.
FAQ
Can I test the APK in the Android Studio emulator? Not an immersive VR app. You need a headset, or the Meta XR Simulator for a Windows build. See Test your Quest VR game without a headset.
Do I need the Meta XR plugin to package for Quest? No. We shipped our build with Unreal’s built-in OpenXR and OpenXR Hand Tracking plugins. The Meta XR plugin adds Meta-specific features you may want later.
Will a newer Android Studio break this again? It can. If Gradle fails right after an Android Studio update, check which Java version JAVA_HOME and Location of JAVA point to first.