dusklight/platforms/android/README.md

Android Shell

This directory contains a minimal SDLActivity-based Android app wrapper for Dusklight.

Prerequisites

• Android SDK installed (ANDROID_HOME)
• Android NDK version used by CMake presets (ANDROID_NDK_VERSION)
• JDK 17+

Example:

export ANDROID_HOME="$HOME/Android/Sdk"
export ANDROID_NDK_VERSION="29.0.14206865"
export JAVA_HOME="/usr/lib/jvm/java-17-openjdk"

Build Native Libraries

cmake --preset android-arm64
cmake --build --preset android-arm64

This build produces build/android-arm64/libmain.so

Refresh SDL Java Shim (Optional)

If you update SDL and want to refresh the embedded Java shim files:

./android/scripts/sync-sdl-java.sh

Build APK

cd android
./gradlew :app:assembleDebug

Output APK:

• android/app/build/outputs/apk/debug/app-debug.apk

Launch With Runtime Args (adb)

You can pass command-line args through the activity intent:

adb shell am start -n dev.twilitrealm.dusk/.DuskActivity \
  --es dusk_args "--backend vulkan"

Supported extras:

• dusk_args: single shell-like argument string
• dusk_argv: string-array argv