This directory mirrors Super3's Android setup (AGP, NDK, SDK levels) and wires up SDL2 for an Android-native entry point. It currently builds a minimal SDL2 bootstrap (see app/src/main/cpp/xemu_android.cpp) that opens an ES context and runs an event loop. The xemu core is not yet wired.

Toolchain expectations

Android SDK 36
Build Tools 36.1.0
NDK r29+ (configured to 29.0.14206865 in Gradle)
CMake 3.30.3
Meson
Ninja
JDK 21
Rust toolchain (cargo) for the ISO->XISO converter and DSP JIT backend
- On Windows, this project uses stable-x86_64-pc-windows-gnu (to avoid MSVC link.exe)
- Install once:
  - rustup toolchain install stable-x86_64-pc-windows-gnu
  - rustup target add aarch64-linux-android --toolchain stable-x86_64-pc-windows-gnu

Rust is now required for Android builds because the DSP JIT backend is built from source. -DXEMU_ENABLE_XISO_CONVERTER=OFF only disables the ISO->XISO converter; it does not remove the DSP JIT Rust dependency.

Build

From this directory:

./gradlew assembleDebug

SDL2

SDL2 is fetched via CMake (default release-2.32.10). To use a local checkout:

./gradlew assembleDebug -Pandroid.experimental.cmake.arguments=-DSDL2_LOCAL_DIR=/path/to/SDL

Core integration note

Mainline xemu moved to SDL3 on 2026-01-21. The last SDL2-based tag is v0.8.133. If you plan to wire the core into Android with SDL2, start from that tag or cherry-pick the SDL2-based frontend changes.