IFTerpCrossCompileAndroid

Interactive Fiction Interpreter Cross Compile Androd

This project serves to demonstrate a working file structure and makefiles to cross-compile established Interactive Fiction interpreter and Glk library for modern Android NDK r15c.

It will complie the interpreter Glulxe and library RemGlk into a applicaiton binary that can be run on android device or emulator. It is configured to generate every variation of process arhitecture that the Android NDK supports. It uses the gcc compiler instead of clang compiler given that gcc is the most well-known in terms of the various IF virtual machines on both 32bit and 64bit systems. However, note that gcc has been depreciated and clang is Google's official NDK recommendation. If you can share and test clang compiler equivlent makefiles, please do, open an Issue on this GitHub project.

Typical Steps

Tested on Ubuntu 17.04 x86 system, latest Google Android NDK from Android Studio as of 2017-08-07. Bash is not required, you could manually run the commands inside of the checkout_terps_and_glk.sh script. These basic steps should work on Linux, OS X, Windows, etc - as long as you have the Android NDK properly installed and some way to download the IF interpreter and RemGlk.

$ chmod +x checkout_terps_and_glk.sh
$ ./checkout_terps_and_glk.sh
$ cd src/main/jni
$ ndk-build

From here, to test on Android 7.1.1 emulator, x86, add these steps:

$ cd ../obj/local
$ adb push x86/glulxe /data/local/tmp
$ adb shell
  Now on Android shell:
  $ cd /data/local/tmp
  $ chmod +x glulxe
  $ ./glulxe

At this point you should be able to send JSON to stdin to interface with the RemGlk that is on top of Glulxe interpreter.