xemu/android/README.md

xemu Android bootstrap

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
• JDK 21

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.