Use the libretro VFS interface in libretro builds

[white-axe]

The libretro API provides a virtual filesystem interface that libretro cores can use to perform filesystem operations. It allows the libretro frontend to expose filesystem functionality that's not available through the native filesystem calls, such as the Storage Access Framework filesystem driver I added to the Android builds of RetroArch in libretro/RetroArch#18336.

This pull request changes the libretro builds of EasyRPG Player to request the libretro VFS interface from the libretro frontend, and then, if it's available, replace NativeFilesystem with a new LibretroFilesystem that uses the libretro VFS interface instead of the native filesystem calls.

[Ghabry]

Great to see that RetroArch is finally getting SAF support on Android.

Also interesting to see the implementation being completely different to our SAF approach. We use wrapper classes in Java to do all the heavy lifting and you call everything via JNI and use C code.

Code looks solid. Will do some testing on Android soon.

[Ghabry]

Jenkins: test this please

(ignore the lint error, is unrelated)

[Ghabry]

Made now some tests and their are some behaviours in the player code that break the Android side. Will try to fix them myself as they are also affecting other components on other platforms:

• The Player code removes the saf:// prefix for whatever reason. Just deleting that code makes it work 🤷
• MakeDirectory must actually create them recursively. That needs documentation and a helper function
• When inside a ZIP the save directory discovery fails (not sure why)

Besides this it appears to work inside a saf document tree. Good job.

[Ghabry]

@white-axe btw is their a simple way to test the core from Android Studio? (including debugger support)

Currently I just use adb + root permissions to manually copy the so-file in the retroarch data folder but their must be a better way

[white-axe]

You don't have to copy the core file into the directory where RetroArch normally looks for the cores. Instead, copy it anywhere and then specify the core path when launching RetroArch:

adb push <path to the core on your computer> /data/local/tmp/libretro_android.so
adb shell am start -n com.retroarch/com.retroarch.browser.debug.CoreSideloadActivity -e LIBRETRO /data/local/tmp/libretro_android.so -e ROM <path to the game on your Android device>

SAF paths are supported for the ROM path, either in the form of the saf:// paths that appear in RetroArch's history when you run the game from the GUI or in the form of a SAF content:// URI (only for nightly builds of RetroArch currently in the latter case).

[Ghabry]

Jenkins: test this please

wow this was surprisingly complecated as we had too many assumptions how paths are supposed to look like... works now

The only problem I see is that MakeDirectory fails but this seems to be a libretro bug in the saf code:

07-29 15:28:28.120 30447 30474 I RetroArch: Tree: MAP0001
07-29 15:28:32.401 30447 30474 I RetroArch: MakeDirectory saf://content:%2F%2Fcom.android.externalstorage.documents%2Ftree%2Fprimary%253AEasyRPG%252Fgames/string-var.zip.save/string-var/Text failed
07-29 15:28:32.401 30447 30474 I RetroArch: Maniac String Op ToFile failed. Cannot create directory Text

The same code works when using the "real path" (/storage/0 etc.) instead of SAF.

As this isn't fixable I don't think its relevant for us.

---

Guess libretro should URI encode the path here?

[Ghabry]

Jenkins: Test this please

EDIT: Tested and confirmed working by Mimigris and me.