=======================
Android wrapper for running Freespace Open on Android
Note: This is experimental, do not expect a fully playable game out of this.
Follow the progress here: scp-fs2open/fs2open.github.com#6992
It was originally intended that Knossos.NET would work along with this Wrapper to run FSO on Android, as i started to learn more about Android limits and how it worked and how much i could do with the Knossos.NET C# Avalonia project for android i ended up dropping this idea, Knossos.NET can do all the required work alone. So all the changes to add an IPC service that Knossos would have used were reverted.
Now this project has new objectives:
- Test FSO android versions without having to use Knossos.
- Develop (and compile) the touch control interface that is also used by Knossos.NET
- Example/Template for FSO TC mods wanting to release it as a standalone android game.
1a) Or get the a prebuilt FSO version for android from here: https://github.com/Shivansps/Fso-Android-Prebuilts/releases
1b) Or Build FSO for Android (From Linux X64)
-Clone this repo/branch: https://github.com/Shivansps/fs2open.github.com/tree/android-build
-Follow the instructions here to get the dependencies https://github.com/scp-fs2open/fs2open.github.com/wiki/Building-on-Linux
-Build the embedfile, by building the FSO tools first. Follow the instructions on the previous step but instead of the normal cmake command, use "cmake -DFSO_BUILD_TOOLS .."
-Get the prebuilt libs fso needs for android: https://github.com/Shivansps/Fso-Android-Prebuilts (also contain prebuilt FSO bins ready to use with this proyect)
-Get the android NDK: https://developer.android.com/ndk/downloads
-Compile FSO with:
cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=/path/to/ndk/build/cmake/android.toolchain.cmake -DANDROID_ABI=arm64-v8a -DANDROID_PLATFORM=android-31 -DEMBEDFILE_PATH=/path/to/embedfile -DFSO_PREBUILT_OVERRIDE=/path/to/prebuilt/libs/folder -G Ninja && sed -i 's/-lusb-1.0//' build.ninja
- Copy: "libavcodec.so, libavformat.so, libavutil.so, libfs2_open_24_3_0_arm64.so, libopenal.so, libSDL2.so, libswresample.so, libswscale.so" from the bin folder to this project "Fso_Android_Wrapper\app\src\main\jniLibs\arm64-v8a" folder.
- From here you can build/deploy/whatever
- Default folder for game assets FSO can see and is accessible via USB folder browsing is "[phone][internal storage]\Android\data\com.shivansps.fsowrapper\files". The path is the same for sdcard or external usb drives.
- Keep in mind OpenGL ES will never be able to run the built-in FSO shaders, you need to include/use external shaders changed for OpenGL ES. The wrapper already include 0_shaders_v2.vp in its assets folder and it will always copy it to any workfolder before launching the app.