mirror of
https://github.com/TwilitRealm/dusklight
synced 2026-07-31 07:45:48 -04:00
CraftyBoss
417360b1ce
currently builds a "Metaforce" apk, will need to change name of course. Running the apk using Android Studio's emulator can get in game, however running on a samsung phone does not seem to work.
78 lines
1.6 KiB
Markdown
78 lines
1.6 KiB
Markdown
# Android Shell
|
|
|
|
This directory contains a minimal SDLActivity-based Android app wrapper for Metaforce.
|
|
|
|
## 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
|
|
|
|
cmake --preset android-x86_64
|
|
cmake --build --preset android-x86_64
|
|
```
|
|
|
|
These builds produce:
|
|
|
|
- `build/android-arm64/Binaries/libmain.so`
|
|
- `build/android-x86_64/Binaries/libmain.so`
|
|
|
|
## Stage Libraries Into APK Project
|
|
|
|
```bash
|
|
./android/scripts/stage-jni-libs.sh
|
|
```
|
|
|
|
This copies:
|
|
|
|
- `libmain.so` -> `android/app/src/main/jniLibs/arm64-v8a/`
|
|
- `libmain.so` -> `android/app/src/main/jniLibs/x86_64/`
|
|
|
|
## 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 com.axiodl.metaforce/.MetaforceActivity \
|
|
--es metaforce_args "'/sdcard/Download/Metroid Prime (USA).iso' --warp 2 17"
|
|
```
|
|
|
|
Supported extras:
|
|
|
|
- `metaforce_args`: single shell-like argument string
|
|
- `metaforce_argv`: string-array argv
|
|
- `metaforce_disc`: compatibility shortcut (single ISO path)
|