mirror of https://git.sr.ht/~rabbits/uxn
45 lines
1.5 KiB
Markdown
45 lines
1.5 KiB
Markdown
# Uxn on Android
|
|
|
|
This is a working port of Uxn to run on Android.
|
|
|
|
## Guide
|
|
|
|
To get a proper on-screen keyboard, install
|
|
[Hacker's Keyboard](https://play.google.com/store/apps/details?id=org.pocketworkstation.pckeyboard).
|
|
Use it naturally, as you would use a physical keyboard,
|
|
including pressing and holding modifiers (Ctrl, Alt, etc) with letters
|
|
if a ROM requires it (like Noodle, to load or save an image).
|
|
|
|
Another alternative keyboard is [Multiling O](https://play.google.com/store/apps/details?id=kl.ime.oh).
|
|
|
|
Tapping anywhere outside of ROM screen area will toggle the keyboard.
|
|
|
|
`F4` will invoke "boot" ROM, which displays all the ROMs available for loading,
|
|
including those you once downloaded with a browser and then opened using Uxn.
|
|
|
|
## Building yourself
|
|
|
|
Easiest way to start is to install JDK first, then [Android
|
|
Studio](https://developer.android.com/studio) and make sure NDK is
|
|
there to use on your computer. Your OS package manager might already
|
|
have the packages required, if you're willing to go that route.
|
|
|
|
Make sure environment is properly configured:
|
|
|
|
; ls $ANDROID_HOME
|
|
build-tools emulator licenses ndk patcher platform-tools platforms tools
|
|
|
|
You should be able to build now:
|
|
|
|
; cd uxn; ./build --no-run # need boot.rom to be included
|
|
|
|
; cd src/android; ./gradlew assembleDebug # now the APK
|
|
............
|
|
BUILD SUCCESSFUL in 111s
|
|
31 actionable tasks: 3 executed, 28 up-to-date
|
|
|
|
; find app -name *.apk
|
|
app/build/outputs/apk/debug/app-debug.apk
|
|
|
|
Refer to Android development documentation for more details.
|