mirror of
https://github.com/TwilitRealm/dusklight
synced 2026-07-29 23:27:25 -04:00
Irastris
60 lines
1.1 KiB
Markdown
60 lines
1.1 KiB
Markdown
# 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:
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
./android/scripts/sync-sdl-java.sh
|
|
```
|
|
|
|
## Build APK
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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
|